Deployment Runs

List Deployment Runs

GET/v1/deployment_runs

Get Deployment Run

GET/v1/deployment_runs/{deployment_run_id}

Models

BetaManagedAgentsAgentArchivedRunError object{ message, type }

The deployment's agent was archived.

message: string

Human-readable error description.

type: "agent_archived_error"

BetaManagedAgentsDeploymentRun object{ id, agent, created_at, 5 more }

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

BetaManagedAgentsEnvironmentArchivedRunError object{ message, type }

The deployment's environment was archived.

message: string

Human-readable error description.

type: "environment_archived_error"

BetaManagedAgentsEnvironmentNotFoundRunError object{ message, type }

The deployment's environment no longer exists.

message: string

Human-readable error description.

type: "environment_not_found_error"

BetaManagedAgentsFileNotFoundRunError object{ message, type }

A file resource referenced by the deployment no longer exists.

message: string

Human-readable error description.

type: "file_not_found_error"

BetaManagedAgentsManualTriggerContext object{ type }

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

type: "manual"

BetaManagedAgentsMCPEgressBlockedRunError object{ message, type }

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

message: string

Human-readable error description.

type: "mcp_egress_blocked_error"

BetaManagedAgentsMemoryStoreArchivedRunError object{ message, type }

A memory store referenced by the deployment is archived.

message: string

Human-readable error description.

type: "memory_store_archived_error"

BetaManagedAgentsOrganizationDisabledRunError object{ message, type }

The deployment's organization is disabled.

message: string

Human-readable error description.

type: "organization_disabled_error"

BetaManagedAgentsScheduleTriggerContext object{ scheduled_at, type }

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

scheduled_at: string

A timestamp in RFC 3339 format

formatdate-time

type: "schedule"

BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object{ message, type }

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

message: string

Human-readable error description.

type: "self_hosted_resources_unsupported_error"

BetaManagedAgentsSessionCreationRejectedRunError object{ message, type }

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

message: string

Human-readable error description.

type: "session_creation_rejected_error"

BetaManagedAgentsSessionRateLimitedRunError object{ message, type }

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

message: string

Human-readable error description.

type: "session_rate_limited_error"

BetaManagedAgentsSessionResourceNotFoundRunError object{ message, type }

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

message: string

Human-readable error description.

type: "session_resource_not_found_error"

BetaManagedAgentsSkillNotFoundRunError object{ message, type }

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

message: string

Human-readable error description.

type: "skill_not_found_error"

BetaManagedAgentsTriggerContext = BetaManagedAgentsScheduleTriggerContext { scheduled_at, type } or BetaManagedAgentsManualTriggerContext { type }

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

One of the following:

BetaManagedAgentsScheduleTriggerContext object{ scheduled_at, type }

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

scheduled_at: string

A timestamp in RFC 3339 format

formatdate-time

type: "schedule"

BetaManagedAgentsManualTriggerContext object{ type }

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

type: "manual"

BetaManagedAgentsTriggerType = "schedule" or "manual"

What triggered a deployment run.

One of the following:

"schedule"

"manual"

BetaManagedAgentsUnknownRunError object{ message, type }

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: string

Human-readable error description.

type: "unknown_error"

BetaManagedAgentsVaultArchivedRunError object{ message, type }

A vault referenced by the deployment is archived.

message: string

Human-readable error description.

type: "vault_archived_error"

BetaManagedAgentsVaultNotFoundRunError object{ message, type }

A vault referenced by the deployment no longer exists.

message: string

Human-readable error description.

type: "vault_not_found_error"

BetaManagedAgentsWorkspaceArchivedRunError object{ message, type }

The deployment's workspace was archived.

message: string

Human-readable error description.

type: "workspace_archived_error"