Skip to content
Embabel Worlds

One agent's A2A card

GET
/api/v1/agents/{name}/a2a/.well-known/agent-card.json
curl --request GET \
  --url http://localhost:11044/api/v1/agents/example/a2a/.well-known/agent-card.json \
  --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
name
required
string

The agent’s name

Responses

Section titled “Responses”

200

Section titled “200”

The card

Media typeapplication/json
object
additionalInterfaces
Array<object>
object
transport
string
url
string
capabilities
object
extensions
Array<object>
object
description
string
params
object
key
additional properties
required
boolean
uri
string
pushNotifications
boolean
stateTransitionHistory
boolean
streaming
boolean
defaultInputModes
Array<string>
defaultOutputModes
Array<string>
description
string
documentationUrl
string
iconUrl
string
name
string
preferredTransport
string
protocolVersion
string
provider
object
organization
string
url
string
security
Array<object>
object
key
additional properties
Array<string>
securitySchemes
object
key
additional properties
One of:
object
description
string
type
required
string
in
string
name
string
type
required
string
signatures
Array<object>
object
header
object
key
additional properties
protected
string
signature
string
skills
Array<object>
object
description
string
examples
Array<string>
id
string
inputModes
Array<string>
name
string
outputModes
Array<string>
security
Array<object>
object
key
additional properties
Array<string>
tags
Array<string>
supportsAuthenticatedExtendedCard
boolean
url
string
version
string

Example generated

{
  "additionalInterfaces": [
    {
      "transport": "example",
      "url": "example"
    }
  ],
  "capabilities": {
    "extensions": [
      {
        "description": "example",
        "params": {
          "additionalProperty": "example"
        },
        "required": true,
        "uri": "example"
      }
    ],
    "pushNotifications": true,
    "stateTransitionHistory": true,
    "streaming": true
  },
  "defaultInputModes": [
    "example"
  ],
  "defaultOutputModes": [
    "example"
  ],
  "description": "example",
  "documentationUrl": "example",
  "iconUrl": "example",
  "name": "example",
  "preferredTransport": "example",
  "protocolVersion": "example",
  "provider": {
    "organization": "example",
    "url": "example"
  },
  "security": [
    {
      "additionalProperty": [
        "example"
      ]
    }
  ],
  "securitySchemes": {
    "additionalProperty": {
      "description": "example",
      "type": "example",
      "in": "example",
      "name": "example"
    }
  },
  "signatures": [
    {
      "header": {
        "additionalProperty": "example"
      },
      "protected": "example",
      "signature": "example"
    }
  ],
  "skills": [
    {
      "description": "example",
      "examples": [
        "example"
      ],
      "id": "example",
      "inputModes": [
        "example"
      ],
      "name": "example",
      "outputModes": [
        "example"
      ],
      "security": [
        {
          "additionalProperty": [
            "example"
          ]
        }
      ],
      "tags": [
        "example"
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": true,
  "url": "example",
  "version": "example"
}

401

Section titled “401”

No API key or session

Media typeapplication/json

The error object of a JSON-RPC response; the A2A card endpoints also answer a refusal with it as the whole body.

object
code
required

JSON-RPC or A2A error code: -32600 invalid request (also an agent that cannot be talked to now, or that this key may not reach), -32601 method not found, -32602 invalid params, -32603 internal error, -32001 task not found, -32002 task not cancelable, -32003 push notifications not supported, -32004 unsupported operation

integer format: int32
message
required

What went wrong, in words for a person to read

string

Example generated

{
  "code": 1,
  "message": "example"
}

403

Section titled “403”

The key does not talk to this agent

Media typeapplication/json

The error object of a JSON-RPC response; the A2A card endpoints also answer a refusal with it as the whole body.

object
code
required

JSON-RPC or A2A error code: -32600 invalid request (also an agent that cannot be talked to now, or that this key may not reach), -32601 method not found, -32602 invalid params, -32603 internal error, -32001 task not found, -32002 task not cancelable, -32003 push notifications not supported, -32004 unsupported operation

integer format: int32
message
required

What went wrong, in words for a person to read

string

Example generated

{
  "code": 1,
  "message": "example"
}

404

Section titled “404”

No agent of that name may be talked to now

Media typeapplication/json

The error object of a JSON-RPC response; the A2A card endpoints also answer a refusal with it as the whole body.

object
code
required

JSON-RPC or A2A error code: -32600 invalid request (also an agent that cannot be talked to now, or that this key may not reach), -32601 method not found, -32602 invalid params, -32603 internal error, -32001 task not found, -32002 task not cancelable, -32003 push notifications not supported, -32004 unsupported operation

integer format: int32
message
required

What went wrong, in words for a person to read

string

Example generated

{
  "code": 1,
  "message": "example"
}