Get the agent A2A card

Beta

GET

/v1/agents/:agentId/a2a/.well-known/agent-card.json

GET

/v1/agents/:agentId/a2a/.well-known/agent-card.json

curl https://api.bctrl.ai/v1/agents/agentId/a2a/.well-known/agent-card.json \
     -H "Authorization: Bearer <token>"

{
  "capabilities": {
    "extendedAgentCard": true,
    "pushNotifications": true,
    "streaming": true
  },
  "defaultInputModes": [
    "string"
  ],
  "defaultOutputModes": [
    "string"
  ],
  "description": "string",
  "name": "string",
  "provider": {
    "organization": "string",
    "url": "string"
  },
  "securityRequirements": [
    {}
  ],
  "securitySchemes": {},
  "skills": [
    {
      "description": "string",
      "id": "string",
      "name": "string",
      "tags": [
        "string"
      ]
    }
  ],
  "supportedInterfaces": [
    {
      "protocolBinding": "string",
      "protocolVersion": "string",
      "url": "string"
    }
  ],
  "version": "string"
}

The Agent2Agent (A2A v1.0) card of this Agent: its JSON-RPC interface, capabilities and bearer API-key security.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

agentIdstringRequired

Response headers

BCTRL-Request-IdstringOptional

Current request identifier, also echoed in errors.

BCTRL-VersionstringOptional

Negotiated dated API version.

RateLimit-Limitinteger

Evaluated policy limit; zero when no finite policy was evaluated.

RateLimit-Remaininginteger

Remaining policy budget; zero when no finite policy was evaluated.

RateLimit-Resetinteger

Seconds until reset; zero when no finite policy was evaluated.

Response

capabilitiesobject

defaultInputModeslist of strings

defaultOutputModeslist of strings

descriptionstring

namestring

providerobject

securityRequirementslist of objects

securitySchemesobject

skillslist of objects

supportedInterfaceslist of objects

versionstring

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

Authentication

Path parameters

Headers

Response headers

Response

Errors