Claude Platform Docs

Запуски развёртывания

Список запусков развёртывания
beta.deployment_runs.list(**kwargs) -> SyncPageCursor[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: Literal["agent_archived_error"]
message: str

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: Literal["environment_archived_error"]
message: str

Human-readable error description.

class BetaManagedAgentsEnvironmentNotFoundRunError: type: "environment_not_found_error"; message

The deployment's environment no longer exists.

type: Literal["environment_not_found_error"]
message: str

Human-readable error description.

class BetaManagedAgentsFileNotFoundRunError: type: "file_not_found_error"; message

A file resource referenced by the deployment no longer exists.

type: Literal["file_not_found_error"]
message: str

Human-readable error description.

class BetaManagedAgentsManualTriggerContext: type: "manual"

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

type: Literal["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: Literal["mcp_egress_blocked_error"]
message: str

Human-readable error description.

class BetaManagedAgentsMemoryStoreArchivedRunError: type: "memory_store_archived_error"; message

A memory store referenced by the deployment is archived.

type: Literal["memory_store_archived_error"]
message: str

Human-readable error description.

class BetaManagedAgentsOrganizationDisabledRunError: type: "organization_disabled_error"; message

The deployment's organization is disabled.

type: Literal["organization_disabled_error"]
message: str

Human-readable error description.

class BetaManagedAgentsScheduleTriggerContext: type: "schedule"; scheduled_at

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

type: Literal["schedule"]
scheduled_at: datetime

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: Literal["self_hosted_resources_unsupported_error"]
message: str

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: Literal["session_creation_rejected_error"]
message: str

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: Literal["session_rate_limited_error"]
message: str

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: Literal["session_resource_not_found_error"]
message: str

Human-readable error description.

class BetaManagedAgentsSkillNotFoundRunError: type: "skill_not_found_error"; message

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

type: Literal["skill_not_found_error"]
message: str

Human-readable error description.

type BetaManagedAgentsTriggerContext = ...

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: Literal["schedule"]
scheduled_at: datetime

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: Literal["manual"]
type BetaManagedAgentsTriggerType = Literal["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: Literal["unknown_error"]
message: str

Human-readable error description.

class BetaManagedAgentsVaultArchivedRunError: type: "vault_archived_error"; message

A vault referenced by the deployment is archived.

type: Literal["vault_archived_error"]
message: str

Human-readable error description.

class BetaManagedAgentsVaultNotFoundRunError: type: "vault_not_found_error"; message

A vault referenced by the deployment no longer exists.

type: Literal["vault_not_found_error"]
message: str

Human-readable error description.

class BetaManagedAgentsWorkspaceArchivedRunError: type: "workspace_archived_error"; message

The deployment's workspace was archived.

type: Literal["workspace_archived_error"]
message: str

Human-readable error description.