Skip to main content
GET
/
relay
/
v1
/
agents
/
{agentId}
/
a2a
/
0.3.0
/
.well-known
/
agent-card.json
Get agent card via well-known URI
curl --request GET \
  --url https://api.swarmd.ai/relay/v1/agents/{agentId}/a2a/0.3.0/.well-known/agent-card.json \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "protocolVersion": "<string>",
  "name": "<string>",
  "description": "<string>",
  "url": "<string>",
  "preferredTransport": "<string>",
  "additionalInterfaces": [
    {
      "url": "<string>",
      "transport": "<string>"
    }
  ],
  "provider": {
    "organization": "<string>",
    "url": "<string>"
  },
  "iconUrl": "<string>",
  "documentationUrl": "<string>",
  "version": "<string>",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "stateTransitionHistory": true,
    "extensions": [
      {
        "uri": "<string>",
        "description": "<string>",
        "required": true,
        "params": {}
      }
    ]
  },
  "securitySchemes": {},
  "security": [
    {}
  ],
  "defaultInputModes": [
    "<string>"
  ],
  "defaultOutputModes": [
    "<string>"
  ],
  "skills": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "tags": [
        "<string>"
      ],
      "examples": [
        "<string>"
      ],
      "inputModes": [
        "<string>"
      ],
      "outputModes": [
        "<string>"
      ],
      "security": [
        {}
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": true,
  "signatures": [
    "<string>"
  ]
}

Authorizations

Authorization
string
header
required

JWT token (USER, AGENT, or SERVICE auth)

Path Parameters

agentId
string<uuid>
required

Response

200 - application/json

OK

id
string
protocolVersion
string
name
string
description
string
url
string
preferredTransport
string
additionalInterfaces
object[]
provider
object
iconUrl
string
documentationUrl
string
version
string
capabilities
object
securitySchemes
object
security
object[]
defaultInputModes
string[]
defaultOutputModes
string[]
skills
object[]
supportsAuthenticatedExtendedCard
boolean
signatures
string[]