Agents
Agents.list
GET
/v1/agentsx-api-key<token>
Workspace API key. Read from the x-api-key header by src/auth/api-key.ts. A key that is present and does not authenticate is final — no other scheme is consulted.
In: header
Query Parameters
limit?integer
Range
1 <= valuepage?string
created_at[gte]?string
Format
date-timecreated_at[lte]?string
Format
date-timeinclude_archived?boolean
Header Parameters
anthropic-beta?string
Accepted for Anthropic SDK compatibility and ignored. No value of this header changes request handling. Typed as a free-form string rather than an enum because this service recognises no specific beta value.
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/agents"{ "data": [ { "id": "string", "type": "agent", "name": "string", "description": "string", "version": 1, "model": { "id": "string", "speed": "standard", "effort": { "type": "low" } }, "system": "string", "tools": [ { "type": "agent_toolset", "default_config": { "enabled": true, "permission_policy": { "type": "always_allow" } }, "configs": [ { "enabled": true, "permission_policy": { "type": "always_allow" }, "name": "string" } ] } ], "mcp_servers": [ { "name": "string", "type": "url", "url": "http://example.com" } ], "skills": [ { "type": "anthropic", "skill_id": "string", "version": "string" } ], "guardrail_ids": [ "string" ], "metadata": { "property1": "string", "property2": "string" }, "multiagent": { "type": "coordinator", "agents": [ "string" ] }, "archived_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "next_page": "string"}