GET
GET /v1/deployments?beta=true — Claude API
Beta
Anthropic API key (required); https://api.anthropic.com
Claude APIList Deployments
- Base URL
- https://api.anthropic.com
- Auth
- x-api-key: <ANTHROPIC_API_KEY>
- Last verified
- 2026-10-20 · upstream hash matched
Actions Try in browser→
Agents: curl -H "Accept: text/markdown" this URL
→ 306 tokens · Vary: Accept
→ 306 tokens · Vary: Accept
Critical gotchas
Authentication uses the x-api-key header and requests also require an anthropic-version header.
The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.
cURL
curl -X GET 'https://api.anthropic.com/v1/deployments?beta=true&limit=10&page=example-page&agent_id=agent-id&status=active&created_at%5Bgte%5D=example-created-at%5Bgte%5D&created_at%5Blte%5D=example-created-at%5Blte%5D&include_archived=true' \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H 'anthropic-version: 2023-06-01'
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | integer | No | Maximum results per page. Default 20, maximum 100. |
| page | query | string | No | Opaque pagination cursor. |
| agent_id | query | string | No | Filter by agent ID. |
| status | query | string | No | Filter by status: `active` or `paused`. Omit for both. To include archived deployments, use `include_archived` instead; the two cannot be combined. |
| created_at[gte] | query | string | No | Return deployments created at or after this time (inclusive). |
| created_at[lte] | query | string | No | Return deployments created at or before this time (inclusive). |
| include_archived | query | boolean | No | When true, includes archived deployments. Default: false (exclude archived). |
Response 200 OK
{
"data": [
{
"type": "deployment",
"id": "depl_011CZkZcDH3vPqd7xnEfwTai",
"name": "Daily order report",
"description": "Compiles yesterday's orders into a report every weekday morning.",
"agent": {
"type": "agent",
"id": "agent_011CZkYpogX7uDKUyvBTophP",
"version": 1
},
"environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
"vault_ids": [
"vlt_011CZkZDLs7fYzm1hXNPeRjv"
],
"initial_events": [
{
"type": "user.message",
"content": [
{
"type": "text",
"text": "Compile yesterday's orders into report.md."
}
]
}
],
"resources": [],
"metadata": {},
"schedule": {
"type": "cron",
"expression": "0 9 * * 1-5",
"timezone": "America/Los_Angeles",
"last_run_at": "2026-03-16T16:00:09Z",
"upcoming_runs_at": [
"2026-03-17T16:00:00Z",
"2026-03-18T16:00:00Z"
]
},
"status": "active",
"paused_reason": null,
"created_at": "2026-03-15T10:00:00Z",
"updated_at": "2026-03-15T10:00:00Z",
"archived_at": null
}
],
"next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
} Get a free Claude API key → sponsored Affiliate link - we may earn a commission, at no extra cost to you.