BerriAI/litellm · error · HTTPException

pushNotificationConfig must be an object

Error message

pushNotificationConfig must be an object

What it means

Raised in the A2A JSON-RPC handler for tasks/pushNotificationConfig/set when the request does include a pushNotificationConfig member but it is not a JSON object (e.g. a string or list). It is the second-stage check: params itself was already verified to be a dict; this one validates the nested config shape before it is normalized and forwarded to the agent.

Source

Thrown at litellm/proxy/agent_endpoints/a2a_endpoints.py:883

            "tasks/pushNotificationConfig/set",
            "tasks/pushNotificationConfig/get",
            "tasks/pushNotificationConfig/list",
            "tasks/pushNotificationConfig/delete",
            "agent/getAuthenticatedExtendedCard",
        }:
            if not agent_url:
                return _jsonrpc_error(request_id, -32000, f"Agent '{agent_id}' has no URL configured", 500)
            if isinstance(params, dict):
                params = normalize_request_params(params, served_version, method=method)
            if method == "tasks/pushNotificationConfig/set":
                if not isinstance(params, dict):
                    raise HTTPException(
                        status_code=400,
                        detail="params must be an object",
                    )
                push_config: Final = params.get("pushNotificationConfig", {})
                if "pushNotificationConfig" in params and not isinstance(push_config, dict):
                    raise HTTPException(
                        status_code=400,
                        detail="pushNotificationConfig must be an object",
                    )
                for callback_url in (params.get("url"), push_config.get("url")):
                    if not callback_url:
                        continue
                    if not isinstance(callback_url, str):
                        raise HTTPException(
                            status_code=400,
                            detail="Push notification URL must be a string",
                        )
                    _validate_push_notification_url(callback_url)
            forward_body: dict[str, object] = {
                "jsonrpc": "2.0",
                "id": request_id,
                "method": method,
                "params": params,
            }

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Send pushNotificationConfig as a JSON object.

Example fix

pushNotificationConfig={'url':'https://...'}

When it happens

Trigger: Thrown at litellm/proxy/agent_endpoints/a2a_endpoints.py:883 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/e9111ae711d84c25. Report an issue: GitHub.