Claude Platform Docs

Deployment Runs

List Deployment Runs
beta.deployment_runs.list(DeploymentRunListParams**kwargs) -> SyncPageCursor[BetaManagedAgentsDeploymentRun]
GET/v1/deployment_runs
Get Deployment Run
beta.deployment_runs.retrieve(strdeployment_run_id, DeploymentRunRetrieveParams**kwargs) -> BetaManagedAgentsDeploymentRun
GET/v1/deployment_runs/{deployment_run_id}
Models
class BetaManagedAgentsAgentArchivedRunError: …

The deployment's agent was archived.

message: str

Human-readable error description.

type: Literal["agent_archived_error"]
class BetaManagedAgentsDeploymentRun: …

A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.

class BetaManagedAgentsEnvironmentArchivedRunError: …

The deployment's environment was archived.

message: str

Human-readable error description.

type: Literal["environment_archived_error"]
class BetaManagedAgentsEnvironmentNotFoundRunError: …

The deployment's environment no longer exists.

message: str

Human-readable error description.

type: Literal["environment_not_found_error"]
class BetaManagedAgentsFileNotFoundRunError: …

A file resource referenced by the deployment no longer exists.

message: str

Human-readable error description.

type: Literal["file_not_found_error"]
class BetaManagedAgentsManualTriggerContext: …

The run was started manually by creating a session directly against the deployment.

type: Literal["manual"]
class BetaManagedAgentsMCPEgressBlockedRunError: …

An MCP server host used by the deployment's agent is blocked by the environment's network policy.

message: str

Human-readable error description.

type: Literal["mcp_egress_blocked_error"]
class BetaManagedAgentsMemoryStoreArchivedRunError: …

A memory store referenced by the deployment is archived.

message: str

Human-readable error description.

type: Literal["memory_store_archived_error"]
class BetaManagedAgentsOrganizationDisabledRunError: …

The deployment's organization is disabled.

message: str

Human-readable error description.

type: Literal["organization_disabled_error"]
class BetaManagedAgentsScheduleTriggerContext: …

The run was fired by the deployment's cron schedule.

scheduled_at: datetime

A timestamp in RFC 3339 format

formatdate-time
type: Literal["schedule"]
class BetaManagedAgentsSelfHostedResourcesUnsupportedRunError: …

The deployment configures resources, but its environment is self-hosted and cannot mount them.

message: str

Human-readable error description.

type: Literal["self_hosted_resources_unsupported_error"]
class BetaManagedAgentsSessionCreationRejectedRunError: …

The session create request was rejected with a non-retryable validation error.

message: str

Human-readable error description.

type: Literal["session_creation_rejected_error"]
class BetaManagedAgentsSessionRateLimitedRunError: …

Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.

message: str

Human-readable error description.

type: Literal["session_rate_limited_error"]
class BetaManagedAgentsSessionResourceNotFoundRunError: …

A referenced resource no longer exists and its kind was not reported.

message: str

Human-readable error description.

type: Literal["session_resource_not_found_error"]
class BetaManagedAgentsSkillNotFoundRunError: …

A skill referenced by the deployment's agent no longer exists.

message: str

Human-readable error description.

type: Literal["skill_not_found_error"]
BetaManagedAgentsTriggerContext

Describes what triggered a deployment run, with trigger-specific metadata.

One of the following:
class BetaManagedAgentsScheduleTriggerContext: …

The run was fired by the deployment's cron schedule.

scheduled_at: datetime

A timestamp in RFC 3339 format

formatdate-time
type: Literal["schedule"]
class BetaManagedAgentsManualTriggerContext: …

The run was started manually by creating a session directly against the deployment.

type: Literal["manual"]
Literal["schedule", "manual"]

What triggered a deployment run.

One of the following:
"schedule"
"manual"
class BetaManagedAgentsUnknownRunError: …

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.

message: str

Human-readable error description.

type: Literal["unknown_error"]
class BetaManagedAgentsVaultArchivedRunError: …

A vault referenced by the deployment is archived.

message: str

Human-readable error description.

type: Literal["vault_archived_error"]
class BetaManagedAgentsVaultNotFoundRunError: …

A vault referenced by the deployment no longer exists.

message: str

Human-readable error description.

type: Literal["vault_not_found_error"]
class BetaManagedAgentsWorkspaceArchivedRunError: …

The deployment's workspace was archived.

message: str

Human-readable error description.

type: Literal["workspace_archived_error"]