Deployment Runs

List Deployment Runs

DeploymentRunListPage Beta.DeploymentRuns.List(parameters, cancellationToken = default)

GET/v1/deployment_runs

Get Deployment Run

BetaManagedAgentsDeploymentRun Beta.DeploymentRuns.Retrieve(parameters, cancellationToken = default)

GET/v1/deployment_runs/{deployment_run_id}

Models

class BetaManagedAgentsAgentArchivedRunError { Type = "agent_archived_error"; Message; }

The deployment's agent was archived.

JsonElement Type = "agent_archived_error"

required string Message

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.

JsonElement Type = "environment_archived_error"

required string Message

Human-readable error description.

class BetaManagedAgentsEnvironmentNotFoundRunError { Type = "environment_not_found_error"; Message; }

The deployment's environment no longer exists.

JsonElement Type = "environment_not_found_error"

required string Message

Human-readable error description.

class BetaManagedAgentsFileNotFoundRunError { Type = "file_not_found_error"; Message; }

A file resource referenced by the deployment no longer exists.

JsonElement Type = "file_not_found_error"

required string Message

Human-readable error description.

class BetaManagedAgentsManualTriggerContext { Type = "manual"; }

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

JsonElement 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.

JsonElement Type = "mcp_egress_blocked_error"

required string Message

Human-readable error description.

class BetaManagedAgentsMemoryStoreArchivedRunError { Type = "memory_store_archived_error"; Message; }

A memory store referenced by the deployment is archived.

JsonElement Type = "memory_store_archived_error"

required string Message

Human-readable error description.

class BetaManagedAgentsOrganizationDisabledRunError { Type = "organization_disabled_error"; Message; }

The deployment's organization is disabled.

JsonElement Type = "organization_disabled_error"

required string Message

Human-readable error description.

class BetaManagedAgentsScheduleTriggerContext { Type = "schedule"; ScheduledAt; }

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

JsonElement Type = "schedule"

required DateTimeOffset 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 = "self_hosted_resources_unsupported_error"; Message; }

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

JsonElement Type = "self_hosted_resources_unsupported_error"

required string Message

Human-readable error description.

class BetaManagedAgentsSessionCreationRejectedRunError { Type = "session_creation_rejected_error"; Message; }

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

JsonElement Type = "session_creation_rejected_error"

required string Message

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.

JsonElement Type = "session_rate_limited_error"

required string Message

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.

JsonElement Type = "session_resource_not_found_error"

required string Message

Human-readable error description.

class BetaManagedAgentsSkillNotFoundRunError { Type = "skill_not_found_error"; Message; }

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

JsonElement Type = "skill_not_found_error"

required string Message

Human-readable error description.

class BetaManagedAgentsTriggerContext: union

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

class BetaManagedAgentsScheduleTriggerContext { Type = "schedule"; ScheduledAt; }

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

JsonElement Type = "schedule"

required DateTimeOffset 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 = "manual"; }

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

JsonElement Type = "manual"

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 = "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.

JsonElement Type = "unknown_error"

required string Message

Human-readable error description.

class BetaManagedAgentsVaultArchivedRunError { Type = "vault_archived_error"; Message; }

A vault referenced by the deployment is archived.

JsonElement Type = "vault_archived_error"

required string Message

Human-readable error description.

class BetaManagedAgentsVaultNotFoundRunError { Type = "vault_not_found_error"; Message; }

A vault referenced by the deployment no longer exists.

JsonElement Type = "vault_not_found_error"

required string Message

Human-readable error description.

class BetaManagedAgentsWorkspaceArchivedRunError { Type = "workspace_archived_error"; Message; }

The deployment's workspace was archived.

JsonElement Type = "workspace_archived_error"

required string Message

Human-readable error description.