Sign in

v3

latestOpenAPI 3.0.02026-08-081996601.2 MB
A2A Protocol

Get A2A v1 agent card (well-known)

Returns the v1 Agent Card at the well-known discovery URL /.well-known/a2a/v1/agent-card.json. The card lists every supported transport in supportedInterfaces (the first entry is preferred). v1 clients discover this URL and pick a binding from the list.

get/v2/agents/{agent_key}/.well-known/a2a/v1/agent-card.json

Path parameters

agent_keystring required

A unique key that identifies an agent.

Example:customer_support

The unique key of the agent.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Response

The A2A v1 Agent Card describing this agent.

namestring required

Human-readable name of the agent.

descriptionstring required

Human-readable description of the agent.

versionstring required

Version string of the agent implementation.

documentationUrlstring nullable

URL of the agent's documentation.

securitySchemesobject nullable

Security schemes the agent supports, keyed by scheme name.

securityRequirementsobject[] nullable

Security requirements for the agent. Each entry maps scheme names to scope lists. Entries are alternatives. All schemes in one entry apply together.

defaultInputModesstring[] required

Default media types the agent accepts as input across all skills.

defaultOutputModesstring[] required

Default media types the agent produces as output across all skills.

iconUrlstring nullable

URL of the agent's icon image.