Deployment Runs
List Deployment Runs
Get Deployment Run
Models
BetaManagedAgentsAgentArchivedRunError object{ type: "agent_archived_error", message }The deployment's agent was archived.
The deployment's agent was archived.
Human-readable error description.
BetaManagedAgentsDeploymentRun object{ 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.
A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.
BetaManagedAgentsEnvironmentArchivedRunError object{ type: "environment_archived_error", message }The deployment's environment was archived.
The deployment's environment was archived.
Human-readable error description.
BetaManagedAgentsEnvironmentNotFoundRunError object{ type: "environment_not_found_error", message }The deployment's environment no longer exists.
The deployment's environment no longer exists.
Human-readable error description.
BetaManagedAgentsFileNotFoundRunError object{ type: "file_not_found_error", message }A file resource referenced by the deployment no longer exists.
A file resource referenced by the deployment no longer exists.
Human-readable error description.
BetaManagedAgentsManualTriggerContext object{ type: "manual" }The run was started manually by creating a session directly against the deployment.
The run was started manually by creating a session directly against the deployment.
BetaManagedAgentsMCPEgressBlockedRunError object{ type: "mcp_egress_blocked_error", message }An MCP server host used by the deployment's agent is blocked by the environment's network policy.
An MCP server host used by the deployment's agent is blocked by the environment's network policy.
Human-readable error description.
BetaManagedAgentsMemoryStoreArchivedRunError object{ type: "memory_store_archived_error", message }A memory store referenced by the deployment is archived.
A memory store referenced by the deployment is archived.
Human-readable error description.
BetaManagedAgentsOrganizationDisabledRunError object{ type: "organization_disabled_error", message }The deployment's organization is disabled.
The deployment's organization is disabled.
Human-readable error description.
BetaManagedAgentsScheduleTriggerContext object{ type: "schedule", scheduled_at }The run was fired by the deployment's cron schedule.
The run was fired by the deployment's cron schedule.
scheduled_at: stringA timestamp in RFC 3339 format
A timestamp in RFC 3339 format
BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object{ type: "self_hosted_resources_unsupported_error", message }The deployment configures resources, but its environment is self-hosted and cannot mount them.
The deployment configures resources, but its environment is self-hosted and cannot mount them.
Human-readable error description.
BetaManagedAgentsSessionCreationRejectedRunError object{ type: "session_creation_rejected_error", message }The session create request was rejected with a non-retryable validation error.
The session create request was rejected with a non-retryable validation error.
Human-readable error description.
BetaManagedAgentsSessionRateLimitedRunError object{ type: "session_rate_limited_error", message }Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
Human-readable error description.
BetaManagedAgentsSessionResourceNotFoundRunError object{ type: "session_resource_not_found_error", message }A referenced resource no longer exists and its kind was not reported.
A referenced resource no longer exists and its kind was not reported.
Human-readable error description.
BetaManagedAgentsSkillNotFoundRunError object{ type: "skill_not_found_error", message }A skill referenced by the deployment's agent no longer exists.
A skill referenced by the deployment's agent no longer exists.
Human-readable error description.
BetaManagedAgentsTriggerContext = BetaManagedAgentsScheduleTriggerContext or BetaManagedAgentsManualTriggerContextDescribes what triggered a deployment run, with trigger-specific metadata.
Describes what triggered a deployment run, with trigger-specific metadata.
BetaManagedAgentsScheduleTriggerContext object{ type: "schedule", scheduled_at }The run was fired by the deployment's cron schedule.
The run was fired by the deployment's cron schedule.
scheduled_at: stringA timestamp in RFC 3339 format
A timestamp in RFC 3339 format
BetaManagedAgentsManualTriggerContext object{ type: "manual" }The run was started manually by creating a session directly against the deployment.
The run was started manually by creating a session directly against the deployment.
BetaManagedAgentsTriggerType = "schedule" or "manual"What triggered a deployment run.
What triggered a deployment run.
BetaManagedAgentsUnknownRunError object{ 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.
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.
Human-readable error description.
BetaManagedAgentsVaultArchivedRunError object{ type: "vault_archived_error", message }A vault referenced by the deployment is archived.
A vault referenced by the deployment is archived.
Human-readable error description.
BetaManagedAgentsVaultNotFoundRunError object{ type: "vault_not_found_error", message }A vault referenced by the deployment no longer exists.
A vault referenced by the deployment no longer exists.
Human-readable error description.
BetaManagedAgentsWorkspaceArchivedRunError object{ type: "workspace_archived_error", message }The deployment's workspace was archived.
The deployment's workspace was archived.
Human-readable error description.