List Deployment Runs
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Deployment Runs
Parameters
--created-at-gt: optional stringQuery parameterReturn runs created strictly after this time (exclusive).
Return runs created strictly after this time (exclusive).
--created-at-gte: optional stringQuery parameterReturn runs created at or after this time (inclusive).
Return runs created at or after this time (inclusive).
--created-at-lt: optional stringQuery parameterReturn runs created strictly before this time (exclusive).
Return runs created strictly before this time (exclusive).
--created-at-lte: optional stringQuery parameterReturn runs created at or before this time (inclusive).
Return runs created at or before this time (inclusive).
Filter to a specific deployment. Omit to list across all deployments in the workspace. Filtering by a non-existent deployment_id returns 200 with empty data.
Filter: true for runs with non-null error, false for runs with non-null session_id. Omit for all.
--limit: optional numberQuery parameterMaximum results per page. Default 20, maximum 1000.
Maximum results per page. Default 20, maximum 1000.
Opaque pagination cursor. Pass next_page from the previous response. Invalid or expired cursors return 400.
--trigger-type: optional BetaManagedAgentsTriggerTypeQuery parameterFilter runs by what triggered them. Omit to return all runs.
Filter runs by what triggered them. Omit to return all runs.
The run was fired by the deployment's cron schedule.
The run was started manually by creating a session directly against the deployment.
--beta: optional array of AnthropicBetaHeader parameterThis endpoint is in beta: requests must send managed-agents-2026-04-01 in this header.
This endpoint is in beta: requests must send managed-agents-2026-04-01 in this header.
"message-batches-2024-09-24"Deprecated
"prompt-caching-2024-07-31"Deprecated
"pdfs-2024-09-25"Deprecated
"token-counting-2024-11-01"Deprecated
"token-efficient-tools-2025-02-19"Deprecated
"files-api-2025-04-14"Deprecated
"extended-cache-ttl-2025-04-11"Deprecated
"skills-2025-10-02"Deprecated
"cache-diagnosis-2026-04-07"Deprecated
"ce-user-management-2026-07-13"Deprecated
--workspace-id: optional stringHeader parameterOptional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
Returns
BetaManagedAgentsListDeploymentRunsData: object{ data, next_page }Paginated list of deployment runs. Sorted by created_at descending (most recent first).
Paginated list of deployment runs. Sorted by created_at descending (most recent first).
data: array of BetaManagedAgentsDeploymentRun { type: "deployment_run", id, agent, 5 more }List of deployment runs.
List of deployment runs.
Unique identifier for this run (drun_...).
agent: object{ type: "agent", id, version }Snapshot of the agent at fire time. Always fully resolved — deployments pin agent + version.
Snapshot of the agent at fire time. Always fully resolved — deployments pin agent + version.
version: number
created_at: stringTime this run record was persisted.
Time this run record was persisted.
ID of the deployment that produced this run.
error: BetaManagedAgentsEnvironmentArchivedRunError or BetaManagedAgentsAgentArchivedRunError or BetaManagedAgentsEnvironmentNotFoundRunError or 13 morePopulated on creation failure. Null on success. Exactly one of session_id or error is non-null.
Populated on creation failure. Null on success. Exactly one of session_id or error is non-null.
beta_managed_agents_environment_archived_run_error: object{ type: "environment_archived_error", message }The deployment's environment was archived.
The deployment's environment was archived.
Human-readable error description.
beta_managed_agents_agent_archived_run_error: object{ type: "agent_archived_error", message }The deployment's agent was archived.
The deployment's agent was archived.
Human-readable error description.
beta_managed_agents_environment_not_found_run_error: object{ type: "environment_not_found_error", message }The deployment's environment no longer exists.
The deployment's environment no longer exists.
Human-readable error description.
beta_managed_agents_vault_not_found_run_error: object{ type: "vault_not_found_error", message }A vault referenced by the deployment no longer exists.
A vault referenced by the deployment no longer exists.
Human-readable error description.
beta_managed_agents_vault_archived_run_error: object{ type: "vault_archived_error", message }A vault referenced by the deployment is archived.
A vault referenced by the deployment is archived.
Human-readable error description.
beta_managed_agents_file_not_found_run_error: object{ type: "file_not_found_error", message }A file resource referenced by the deployment no longer exists.
A file resource referenced by the deployment no longer exists.
Human-readable error description.
beta_managed_agents_memory_store_archived_run_error: object{ type: "memory_store_archived_error", message }A memory store referenced by the deployment is archived.
A memory store referenced by the deployment is archived.
Human-readable error description.
beta_managed_agents_skill_not_found_run_error: object{ type: "skill_not_found_error", message }A skill referenced by the deployment's agent no longer exists.
A skill referenced by the deployment's agent no longer exists.
Human-readable error description.
beta_managed_agents_session_resource_not_found_run_error: object{ type: "session_resource_not_found_error", message }A referenced resource no longer exists and its kind was not reported.
A referenced resource no longer exists and its kind was not reported.
Human-readable error description.
beta_managed_agents_workspace_archived_run_error: object{ type: "workspace_archived_error", message }The deployment's workspace was archived.
The deployment's workspace was archived.
Human-readable error description.
beta_managed_agents_organization_disabled_run_error: object{ type: "organization_disabled_error", message }The deployment's organization is disabled.
The deployment's organization is disabled.
Human-readable error description.
beta_managed_agents_session_rate_limited_run_error: object{ type: "session_rate_limited_error", message }Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
Human-readable error description.
beta_managed_agents_session_creation_rejected_run_error: object{ type: "session_creation_rejected_error", message }The session create request was rejected with a non-retryable validation error.
The session create request was rejected with a non-retryable validation error.
Human-readable error description.
beta_managed_agents_unknown_run_error: object{ type: "unknown_error", message }An unknown or unexpected error caused the run to fail. A fallback variant; clients that do not recognize a new error type can match on message alone.
An unknown or unexpected error caused the run to fail. A fallback variant; clients that do not recognize a new error type can match on message alone.
Human-readable error description.
beta_managed_agents_self_hosted_resources_unsupported_run_error: object{ type: "self_hosted_resources_unsupported_error", message }The deployment configures resources, but its environment is self-hosted and cannot mount them.
The deployment configures resources, but its environment is self-hosted and cannot mount them.
Human-readable error description.
beta_managed_agents_mcp_egress_blocked_run_error: object{ type: "mcp_egress_blocked_error", message }An MCP server host used by the deployment's agent is blocked by the environment's network policy.
An MCP server host used by the deployment's agent is blocked by the environment's network policy.
Human-readable error description.
Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.
trigger_context: BetaManagedAgentsScheduleTriggerContext or BetaManagedAgentsManualTriggerContextWhat triggered this run and trigger-specific metadata.
What triggered this run and trigger-specific metadata.
beta_managed_agents_schedule_trigger_context: object{ type: "schedule", scheduled_at }The run was fired by the deployment's cron schedule.
The run was fired by the deployment's cron schedule.
scheduled_at: stringThe UTC instant at which the cron expression matched in the configured timezone, before jitter is applied. At most one run is recorded per (deployment_id, scheduled_at) pair.
The UTC instant at which the cron expression matched in the configured timezone, before jitter is applied. At most one run is recorded per (deployment_id, scheduled_at) pair.
beta_managed_agents_manual_trigger_context: object{ type: "manual" }The run was started manually by creating a session directly against the deployment.
The run was started manually by creating a session directly against the deployment.
Opaque cursor for the next page. Null when no more results.
ant beta:deployment-runs list{
"data": [
{
"id": "id",
"agent": {
"id": "agent_011CZkYqphY8vELVzwCUpqiQ",
"type": "agent",
"version": 1
},
"created_at": "2019-12-27T18:11:19.117Z",
"deployment_id": "deployment_id",
"error": {
"message": "message",
"type": "environment_archived_error"
},
"session_id": "session_id",
"trigger_context": {
"scheduled_at": "2019-12-27T18:11:19.117Z",
"type": "schedule"
},
"type": "deployment_run"
}
],
"next_page": "next_page"
}Returns Examples
{
"data": [
{
"id": "id",
"agent": {
"id": "agent_011CZkYqphY8vELVzwCUpqiQ",
"type": "agent",
"version": 1
},
"created_at": "2019-12-27T18:11:19.117Z",
"deployment_id": "deployment_id",
"error": {
"message": "message",
"type": "environment_archived_error"
},
"session_id": "session_id",
"trigger_context": {
"scheduled_at": "2019-12-27T18:11:19.117Z",
"type": "schedule"
},
"type": "deployment_run"
}
],
"next_page": "next_page"
}