List Agents
get/v1/agents?beta=true
Query parameters
limitinteger
Maximum results per page. Default 20, maximum 100.
pagestring
Opaque pagination cursor from a previous response.
created_at[gte]string date-time
A timestamp in RFC 3339 format
Return agents created at or after this time (inclusive).
created_at[lte]string date-time
A timestamp in RFC 3339 format
Return agents created at or before this time (inclusive).
include_archivedboolean
Include archived agents in results. Defaults to false.
Headers
x-api-keystring
anthropic-versionstring
anthropic-betastring
Response
Successful response (OK)
Example response
{
"data": [
{
"type": "agent",
"id": "agent_011CZkYpogX7uDKUyvBTophP",
"version": 1,
"name": "My First Agent",
"description": "A general-purpose starter agent.",
"model": {
"id": "claude-sonnet-4-6",
"speed": "standard"
},
"system": "You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user's task end to end.",
"tools": [
{
"type": "agent_toolset_20260401",
"default_config": {
"enabled": true,
"permission_policy": {
"type": "always_ask"
}
},
"configs": []
}
],
"mcp_servers": [
{
"type": "url",
"name": "example-mcp",
"url": "https://example-server.modelcontextprotocol.io/sse"
}
],
"skills": [
{
"type": "anthropic",
"skill_id": "xlsx",
"version": "1"
},
{
"type": "custom",
"skill_id": "skill_011CZkZFNu9hAbo3jZPRgTlx",
"version": "2"
}
],
"multiagent": null,
"metadata": {
"foo": "bar"
},
"created_at": "2026-03-15T10:00:00Z",
"updated_at": "2026-03-15T10:00:00Z",
"archived_at": null
}
]
}