Get Team Card

Runtime contract

The generated response schema is unspecified. This route returns an A2A Agent Card directly, with the fields described below.

Start the example A2A server and set the same OS_SECURITY_KEY in the client terminal. These examples target reference-team on port 7777. On deployments using scoped bearer authorization, this operation requires teams:read (or a matching broader grant). The authenticated principal determines user identity; X-User-ID is only anonymous attribution and cannot override it.

curl "http://localhost:7777/a2a/teams/reference-team/.well-known/agent-card.json" \
  -H "Authorization: Bearer $OS_SECURITY_KEY"

The response includes name, description, url, version, protocolVersion, capabilities, defaultInputModes, defaultOutputModes, and skills. Optional fields may be null. It is not wrapped in a JSON-RPC result. Card metadata is a discovery description; it does not grant permission to execute the component.

curl --request GET 'https://example.com/a2a/teams/string/.well-known/agent-card.json'

null

{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}