Claude Platform Docs

デプロイメント実行

デプロイメント実行の一覧を取得
beta.deployment_runs.list(**kwargs) -> PageCursor<BetaManagedAgentsDeploymentRun>
GET/v1/deployment_runs
デプロイメント実行を取得
beta.deployment_runs.retrieve(deployment_run_id, **kwargs) -> BetaManagedAgentsDeploymentRun
GET/v1/deployment_runs/{deployment_run_id}
Models
class BetaManagedAgentsAgentArchivedRunError { type: :agent_archived_error, message }

The deployment's agent was archived.

type: :agent_archived_error
message: String

Human-readable error description.

class BetaManagedAgentsDeploymentRun { type: :deployment_run, 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: :environment_archived_error, message }

The deployment's environment was archived.

type: :environment_archived_error
message: String

Human-readable error description.

class BetaManagedAgentsEnvironmentNotFoundRunError { type: :environment_not_found_error, message }

The deployment's environment no longer exists.

type: :environment_not_found_error
message: String

Human-readable error description.

class BetaManagedAgentsFileNotFoundRunError { type: :file_not_found_error, message }

A file resource referenced by the deployment no longer exists.

type: :file_not_found_error
message: String

Human-readable error description.

class BetaManagedAgentsManualTriggerContext { type: :manual }

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

type: :manual
class BetaManagedAgentsMCPEgressBlockedRunError { type: :mcp_egress_blocked_error, message }

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

type: :mcp_egress_blocked_error
message: String

Human-readable error description.

class BetaManagedAgentsMemoryStoreArchivedRunError { type: :memory_store_archived_error, message }

A memory store referenced by the deployment is archived.

type: :memory_store_archived_error
message: String

Human-readable error description.

class BetaManagedAgentsOrganizationDisabledRunError { type: :organization_disabled_error, message }

The deployment's organization is disabled.

type: :organization_disabled_error
message: String

Human-readable error description.

class BetaManagedAgentsScheduleTriggerContext { type: :schedule, scheduled_at }

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

type: :schedule
scheduled_at: Time

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: :self_hosted_resources_unsupported_error, message }

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

type: :self_hosted_resources_unsupported_error
message: String

Human-readable error description.

class BetaManagedAgentsSessionCreationRejectedRunError { type: :session_creation_rejected_error, message }

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

type: :session_creation_rejected_error
message: String

Human-readable error description.

class BetaManagedAgentsSessionRateLimitedRunError { type: :session_rate_limited_error, message }

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

type: :session_rate_limited_error
message: String

Human-readable error description.

class BetaManagedAgentsSessionResourceNotFoundRunError { type: :session_resource_not_found_error, message }

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

type: :session_resource_not_found_error
message: String

Human-readable error description.

class BetaManagedAgentsSkillNotFoundRunError { type: :skill_not_found_error, message }

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

type: :skill_not_found_error
message: String

Human-readable error description.

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

One of the following:
class BetaManagedAgentsScheduleTriggerContext { type: :schedule, scheduled_at }

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

type: :schedule
scheduled_at: Time

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: :manual }

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

type: :manual
type BetaManagedAgentsTriggerType = :schedule | :manual

What triggered a deployment run.

One of the following:
:schedule

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

:manual

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

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

type: :unknown_error
message: String

Human-readable error description.

class BetaManagedAgentsVaultArchivedRunError { type: :vault_archived_error, message }

A vault referenced by the deployment is archived.

type: :vault_archived_error
message: String

Human-readable error description.

class BetaManagedAgentsVaultNotFoundRunError { type: :vault_not_found_error, message }

A vault referenced by the deployment no longer exists.

type: :vault_not_found_error
message: String

Human-readable error description.

class BetaManagedAgentsWorkspaceArchivedRunError { type: :workspace_archived_error, message }

The deployment's workspace was archived.

type: :workspace_archived_error
message: String

Human-readable error description.