List Deployments
List every scheduled-deployment configuration of an agent.
/anthropic/v1/deployments○ UnsupportedRequest parameters
agent_idstring可选query: Filter results by agent ID.
created_at[gte]string可选query: Return records created at or after this time.
created_at[lte]string可选query: Return records created at or before this time.
include_archivedboolean可选query: Whether to include archived records.
statusstring可选query: Filter by status: active or paused.
limitnumber可选query: Maximum number of items per page.
pagestring可选query: Pagination cursor taken from the previous response's next_page.
Returns
501 This endpoint is not implemented yet; calling it returns the response below:
The platform cannot run agents automatically on a schedule or by trigger yet. Calling it returns 501 (not_implemented_error), produces no side effects, and the official SDK does not retry.
Errors follow the Claude Managed Agents format — see error codes
Response
HTTP 200
Successful response
application/json
| Name | Type | Description |
|---|---|---|
| data | array<object> | |
| data[].id | string | Unique identifier for this deployment. |
| data[].agent | object | A resolved agent reference with a concrete version. |
| data[].archived_at | null | string | A timestamp in RFC 3339 format |
| data[].created_at | string | A timestamp in RFC 3339 format |
| data[].description | null | string | Description of what the deployment does. |
| data[].environment_id | string | ID of the `environment` where sessions run. |
| data[].initial_events | array<object> | Events sent to each session immediately after creation. |
| data[].metadata | object | Arbitrary key-value metadata. Maximum 16 pairs. |
| data[].name | string | Human-readable name. |
| data[].paused_reason | null | object | Why a deployment is paused. Non-null exactly when `status` is `paused`. |
| data[].resources | array<object> | Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials. |
| data[].schedule | null | object | 5-field POSIX cron schedule with computed runtime timestamps. |
| data[].status | string | Lifecycle status of a deployment. |
| data[].type | string | |
| data[].updated_at | string | A timestamp in RFC 3339 format |
| data[].vault_ids | array<string> | Vault IDs supplying stored credentials for sessions created from this deployment. |
| data[].budget | null | object | A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`. |
| next_page | string | null |