List A2A Agents
GET /a2a_agents
GET /a2a_agentsInteractive request editor loads with JavaScript.
Authorization
BearerAdminToken Organization-scoped admin token. Read operations require a valid token, and write operations require a token with write permission.
In: header
Response Body
application/json
application/json
curl -X GET "$AISIX_CP/a2a_agents" \ -H "Authorization: Bearer $AISIX_TOKEN"OK
{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b",
"name": "string",
"url": "http://example.com",
"protocol_version": "1.0",
"auth_type": "none",
"timeout_ms": 1,
"enabled": true,
"allowed_environments": [
"2f8fd63c-350f-4e43-9e38-47af879eaada"
],
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
]
}Missing or invalid bearer.
{
"error": {
"code": "UNAUTHENTICATED",
"message": "no org context"
}
}Complete operation details and schema variants
GET /a2a_agents
List A2A Agents
List A2A agents in the authenticated organization. Stored credentials are never included in read responses.
Parameters
Responses
-
200: OK -
data(array, required): A2A agents visible to the authenticated organization. -
data[].id(string, required): A2A agent ID. -
data[].org_id(string, required): Organization ID that owns this A2A agent. -
data[].name(string, required): Organization-unique name used as the URL path segment the agent is exposed under. Names may contain letters, digits,_,., and-, but cannot start or end with a separator character. -
data[].url(string, required): Upstream A2A agent URL. -
data[].protocol_version(string, required): A2A wire-format version pinned for this agent. -
data[].auth_type(string, required): How AISIX authenticates to the upstream agent.none= no credential;bearer= a bearer token supplied assecret;api_key= an API key supplied assecretand sent as thex-api-keyheader. -
data[].timeout_ms(integer, optional): Per-request timeout in milliseconds. AISIX applies its default when this value is unset. -
data[].enabled(boolean, required): Whether the agent is dispatched to the data plane. -
data[].allowed_environments(array, required): Environment UUIDs this agent is projected to. Empty array = projected to no environment. -
data[].created_at(string, required): Time when the A2A agent was created. -
data[].updated_at(string, required): Time when the A2A agent was last updated. -
401: Missing or invalid bearer. -
error(object, required): Error details. -
error.code(string, required): Machine-readable identifier. Examples:UNAUTHENTICATED,INVALID_REQUEST,MASTER_KEY_UNSET,INTERNAL. -
error.message(string, required): Human-readable explanation; safe to surface to operators.
cURL
curl -X GET '$AISIX_CP/a2a_agents' -H 'Authorization: Bearer $AISIX_TOKEN'