Claude Platform Docs

Ejecuciones de despliegue

Listar ejecuciones de despliegue
DeploymentRunListPage beta().deploymentRuns().list(params = DeploymentRunListParams.none(), requestOptions = RequestOptions.none())
GET/v1/deployment_runs
Obtener ejecución de despliegue
BetaManagedAgentsDeploymentRun beta().deploymentRuns().retrieve(params = DeploymentRunRetrieveParams.none(), requestOptions = RequestOptions.none())
GET/v1/deployment_runs/{deployment_run_id}
Models
class BetaManagedAgentsAgentArchivedRunError { type; message; }

The deployment's agent was archived.

Type type
String message

Human-readable error description.

class BetaManagedAgentsDeploymentRun { type; id; agent; /* 5 more */ }

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

class BetaManagedAgentsEnvironmentArchivedRunError { type; message; }

The deployment's environment was archived.

Type type
String message

Human-readable error description.

class BetaManagedAgentsEnvironmentNotFoundRunError { type; message; }

The deployment's environment no longer exists.

Type type
String message

Human-readable error description.

class BetaManagedAgentsFileNotFoundRunError { type; message; }

A file resource referenced by the deployment no longer exists.

Type type
String message

Human-readable error description.

class BetaManagedAgentsManualTriggerContext { type; }

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

Type type
class BetaManagedAgentsMcpEgressBlockedRunError { type; message; }

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

Type type
String message

Human-readable error description.

class BetaManagedAgentsMemoryStoreArchivedRunError { type; message; }

A memory store referenced by the deployment is archived.

Type type
String message

Human-readable error description.

class BetaManagedAgentsOrganizationDisabledRunError { type; message; }

The deployment's organization is disabled.

Type type
String message

Human-readable error description.

class BetaManagedAgentsScheduleTriggerContext { type; scheduledAt; }

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

Type type
LocalDateTime scheduledAt

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.

formatdate-time
class BetaManagedAgentsSelfHostedResourcesUnsupportedRunError { type; message; }

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

Type type
String message

Human-readable error description.

class BetaManagedAgentsSessionCreationRejectedRunError { type; message; }

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

Type type
String message

Human-readable error description.

class BetaManagedAgentsSessionRateLimitedRunError { type; message; }

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

Type type
String message

Human-readable error description.

class BetaManagedAgentsSessionResourceNotFoundRunError { type; message; }

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

Type type
String message

Human-readable error description.

class BetaManagedAgentsSkillNotFoundRunError { type; message; }

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

Type type
String message

Human-readable error description.

class BetaManagedAgentsTriggerContext: union

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

class BetaManagedAgentsScheduleTriggerContext { type; scheduledAt; }

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

Type type
LocalDateTime scheduledAt

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.

formatdate-time
class BetaManagedAgentsManualTriggerContext { type; }

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

Type type
enum BetaManagedAgentsTriggerType

What triggered a deployment run.

SCHEDULE("schedule")

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

MANUAL("manual")

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

class BetaManagedAgentsUnknownRunError { type; 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.

Type type
String message

Human-readable error description.

class BetaManagedAgentsVaultArchivedRunError { type; message; }

A vault referenced by the deployment is archived.

Type type
String message

Human-readable error description.

class BetaManagedAgentsVaultNotFoundRunError { type; message; }

A vault referenced by the deployment no longer exists.

Type type
String message

Human-readable error description.

class BetaManagedAgentsWorkspaceArchivedRunError { type; message; }

The deployment's workspace was archived.

Type type
String message

Human-readable error description.