Skip to main content
GET
Get the A2A agent card

Authorizations

Authorization
string
header
required

OAuth 2.0 / OIDC bearer token.

Tenant-Name
string
header
required

The tenant the request operates within.

Path Parameters

agentId
string<agent-id>
required

Agent identifier (prefixed UUIDv7). Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"

Response

The agent card.

An A2A agent card describing capabilities, skills, and supported interfaces.

name
string
required

Agent display name.

Example:

"Corti Coding Agent"

version
string
required

Agent card version (SemVer).

Example:

"2.0.0"

capabilities
object
required

Agent capability flags (streaming, push notifications).

Example:
supportedInterfaces
object[]
required

A2A protocol bindings. v2 advertises protocolVersion 1.0 only.

Example:
description
string

Agent description.

Example:

"Returns ICD-10 codes for a clinical encounter."

documentationUrl
string<uri>

A URL providing additional documentation about the agent.

iconUrl
string<uri>

Optional URL to an icon for the agent.

defaultInputModes
string[]

Default input media types.

Example:
defaultOutputModes
string[]

Default output media types.

Example:
provider
object

Publishing organization and URL.

Example:
securityRequirements
object[]

Security requirements for contacting the agent.

securitySchemes
object

The security scheme details used for authenticating with this agent.

signatures
object[]

JSON Web Signatures (JWS, RFC 7515) computed for this agent card.

skills
object[]

Skills the agent exposes.

Example: