Sign in
a2a_registration

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 body

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.

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.

Response

Successful Response

agent_cardobject required
urlstring required

Changes