latestOpenAPI 3.1.02026-08-197104501.1 MB

8fbaab4fc7c5

[beta] A2A Agents

Get Agents

Example usage:

curl -X GET "http://localhost:4000/v1/agents"       -H "Content-Type: application/json"       -H "Authorization: Bearer your-key"     ```

Pass `?health_check=true` to filter out agents whose URL is unreachable:

curl -X GET "http://localhost:4000/v1/agents?health_check=true" -H "Content-Type: application/json" -H "Authorization: Bearer your-key" ```

Returns: List[AgentResponse]

get/v1/agents

Query parameters

health_checkboolean

When true, performs a GET request to each agent's URL. Agents with reachable URLs (HTTP status < 500) and agents without a URL are returned; unreachable agents are filtered out.

When true, performs a GET request to each agent's URL. Agents with reachable URLs (HTTP status < 500) and agents without a URL are returned; unreachable agents are filtered out.

Response

Successful Response

agent_idstring required
agent_namestring required
litellm_paramsobject nullable
agent_card_paramsobject required
object_permissionobject nullable
spendnumber nullable
tpm_limitinteger nullable
rpm_limitinteger nullable
session_tpm_limitinteger nullable
session_rpm_limitinteger nullable
static_headersobject nullable
extra_headersstring[] nullable
created_atstring date-time nullable
updated_atstring date-time nullable
created_bystring nullable
updated_bystring nullable