Skip to content
Embabel Worlds

The A2A cards of the agents you can talk to now

GET
/api/v1/a2a/agents
curl --request GET \
  --url http://localhost:11044/api/v1/a2a/agents \
  --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

One card per agent

Media typeapplication/json
Array<object>
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"
}