Claude Platform Docs

Deployment-Runs

Deployment-Runs auflisten
DeploymentRunListPage Beta.DeploymentRuns.List(parameters, cancellationToken = default)
GET/v1/deployment_runs
Deployment-Run abrufen
BetaManagedAgentsDeploymentRun Beta.DeploymentRuns.Retrieve(parameters, cancellationToken = default)
GET/v1/deployment_runs/{deployment_run_id}
Models
class BetaManagedAgentsAgentArchivedRunError { Type; Message; }

The deployment's agent was archived.

required Type Type
required 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.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsEnvironmentNotFoundRunError { Type; Message; }

The deployment's environment no longer exists.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsFileNotFoundRunError { Type; Message; }

A file resource referenced by the deployment no longer exists.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsManualTriggerContext { Type; }

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

required Type Type
class BetaManagedAgentsMcpEgressBlockedRunError { Type; Message; }

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

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsMemoryStoreArchivedRunError { Type; Message; }

A memory store referenced by the deployment is archived.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsOrganizationDisabledRunError { Type; Message; }

The deployment's organization is disabled.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsScheduleTriggerContext { Type; ScheduledAt; }

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

required Type Type
required DateTimeOffset ScheduledAt

A timestamp in RFC 3339 format

formatdate-time
class BetaManagedAgentsSelfHostedResourcesUnsupportedRunError { Type; Message; }

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

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsSessionCreationRejectedRunError { Type; Message; }

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

required Type Type
required 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.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsSessionResourceNotFoundRunError { Type; Message; }

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

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsSkillNotFoundRunError { Type; Message; }

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

required Type Type
required 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.

required Type Type
required DateTimeOffset ScheduledAt

A timestamp in RFC 3339 format

formatdate-time
class BetaManagedAgentsManualTriggerContext { Type; }

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

required Type Type
enum BetaManagedAgentsTriggerType

What triggered a deployment run.

Schedule("schedule")
Manual("manual")
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.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsVaultArchivedRunError { Type; Message; }

A vault referenced by the deployment is archived.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsVaultNotFoundRunError { Type; Message; }

A vault referenced by the deployment no longer exists.

required Type Type
required string Message

Human-readable error description.

class BetaManagedAgentsWorkspaceArchivedRunError { Type; Message; }

The deployment's workspace was archived.

required Type Type
required string Message

Human-readable error description.