[beta] A2A Agents

Discover Agent Card

Fetch the upstream agent's well-known card so the UI can show the admin which skills/capabilities the agent exposes.

Only proxy admins can call this — the UI uses it during agent registration, and we don't want arbitrary keys probing internal URLs.

Example:

curl -X POST "http://localhost:4000/v1/a2a/discover" \
    -H "Authorization: Bearer <admin_key>" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://upstream-agent.example.com"}'
post/v1/a2a/discover

Request

  • Base URL: https://apiclaw.biz (the document declares no server; this is the origin it was published from)
  • URL: https://apiclaw.biz/v1/a2a/discover
  • Auth: API key in header x-litellm-api-key

Request body

urlstring required

Base URL of the upstream agent. Behavior depends on discovery_mode: well_known_fallback (default) tries /.well-known/agent-card.json, /.well-known/agent.json, /agent.json under this URL in order; langgraph_platform hits /.well-known/agent-card.json?assistant_id=<id> instead.

discovery_mode'well_known_fallback' | 'langgraph_platform'

How to locate the upstream agent card.

String-valued so it serializes cleanly over JSON / Pydantic.

paramsobject nullable

Mode-specific parameters. langgraph_platform requires {'assistant_id': <id>}. well_known_fallback ignores this.

Response

Successful Response

urlstring required
agent_cardobject required

Changes

No recorded changes to this operation across all 1 revision of this API.