列出部署运行
列出部署运行
Query parameters
"created_at[gt]": optional stringReturn runs created strictly after this time (exclusive).
Return runs created strictly after this time (exclusive).
"created_at[gte]": optional stringReturn runs created at or after this time (inclusive).
Return runs created at or after this time (inclusive).
"created_at[lt]": optional stringReturn runs created strictly before this time (exclusive).
Return runs created strictly before this time (exclusive).
"created_at[lte]": optional stringReturn 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 numberMaximum 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 BetaManagedAgentsTriggerTypeFilter 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.
Headers
"anthropic-version": optional stringThe version of the Claude API you want to use.
The version of the Claude API you want to use.
Read more about versioning and our version history here.
"anthropic-beta": optional array of AnthropicBetaThis 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.
"anthropic-workspace-id": optional stringOptional 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
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: BetaManagedAgentsAgentReference { 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 more or nullPopulated 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.
BetaManagedAgentsEnvironmentArchivedRunError object{ type: "environment_archived_error", message }The deployment's environment was archived.
The deployment's environment was archived.
Human-readable error description.
BetaManagedAgentsAgentArchivedRunError object{ type: "agent_archived_error", message }The deployment's agent was archived.
The deployment's agent was archived.
Human-readable error description.
BetaManagedAgentsEnvironmentNotFoundRunError 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.
BetaManagedAgentsVaultNotFoundRunError 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.
BetaManagedAgentsVaultArchivedRunError 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.
BetaManagedAgentsFileNotFoundRunError 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.
BetaManagedAgentsMemoryStoreArchivedRunError 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.
BetaManagedAgentsSkillNotFoundRunError 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.
BetaManagedAgentsSessionResourceNotFoundRunError 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.
BetaManagedAgentsWorkspaceArchivedRunError object{ type: "workspace_archived_error", message }The deployment's workspace was archived.
The deployment's workspace was archived.
Human-readable error description.
BetaManagedAgentsOrganizationDisabledRunError object{ type: "organization_disabled_error", message }The deployment's organization is disabled.
The deployment's organization is disabled.
Human-readable error description.
BetaManagedAgentsSessionRateLimitedRunError 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.
BetaManagedAgentsSessionCreationRejectedRunError 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.
BetaManagedAgentsUnknownRunError 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.
BetaManagedAgentsSelfHostedResourcesUnsupportedRunError 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.
BetaManagedAgentsMCPEgressBlockedRunError 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: BetaManagedAgentsTriggerContextWhat triggered this run and trigger-specific metadata.
What triggered this run and trigger-specific metadata.
BetaManagedAgentsScheduleTriggerContext 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.
BetaManagedAgentsManualTriggerContext 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.
curl https://api.anthropic.com/v1/deployment_runs \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"{
"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"
}