# Deployment Runs

## List Deployment Runs

`beta.deployment_runs.list(**kwargs) -> PageCursor<BetaManagedAgentsDeploymentRun>`

**get** `/v1/deployment_runs`

List Deployment Runs

### Parameters

- `created_at_gt: Time`

  Return runs created strictly after this time (exclusive).

- `created_at_gte: Time`

  Return runs created at or after this time (inclusive).

- `created_at_lt: Time`

  Return runs created strictly before this time (exclusive).

- `created_at_lte: Time`

  Return runs created at or before this time (inclusive).

- `deployment_id: String`

  Filter to a specific deployment. Omit to list across all deployments in the workspace. Filtering by a non-existent deployment_id returns 200 with empty data.

- `has_error: bool`

  Filter: true for runs with non-null error, false for runs with non-null session_id. Omit for all.

- `limit: Integer`

  Maximum results per page. Default 20, maximum 1000.

- `page: String`

  Opaque pagination cursor. Pass next_page from the previous response. Invalid or expired cursors return 400.

- `trigger_type: BetaManagedAgentsTriggerType`

  Filter runs by what triggered them. Omit to return all runs.

  - `:schedule`

  - `:manual`

- `betas: Array[AnthropicBeta]`

  Optional header to specify the beta version(s) you want to use.

  - `String = String`

  - `AnthropicBeta = :"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 25 more`

    - `:"message-batches-2024-09-24"`

    - `:"prompt-caching-2024-07-31"`

    - `:"computer-use-2024-10-22"`

    - `:"computer-use-2025-01-24"`

    - `:"pdfs-2024-09-25"`

    - `:"token-counting-2024-11-01"`

    - `:"token-efficient-tools-2025-02-19"`

    - `:"output-128k-2025-02-19"`

    - `:"files-api-2025-04-14"`

    - `:"mcp-client-2025-04-04"`

    - `:"mcp-client-2025-11-20"`

    - `:"dev-full-thinking-2025-05-14"`

    - `:"interleaved-thinking-2025-05-14"`

    - `:"code-execution-2025-05-22"`

    - `:"extended-cache-ttl-2025-04-11"`

    - `:"context-1m-2025-08-07"`

    - `:"context-management-2025-06-27"`

    - `:"model-context-window-exceeded-2025-08-26"`

    - `:"skills-2025-10-02"`

    - `:"fast-mode-2026-02-01"`

    - `:"output-300k-2026-03-24"`

    - `:"user-profiles-2026-03-24"`

    - `:"advisor-tool-2026-03-01"`

    - `:"managed-agents-2026-04-01"`

    - `:"cache-diagnosis-2026-04-07"`

    - `:"thinking-token-count-2026-05-13"`

    - `:"server-side-fallback-2026-06-01"`

    - `:"fallback-credit-2026-06-01"`

### Returns

- `class BetaManagedAgentsDeploymentRun`

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

  - `id: String`

    Unique identifier for this run (`drun_...`).

  - `agent: BetaManagedAgentsAgentReference`

    A resolved agent reference with a concrete version.

    - `id: String`

    - `type: :agent`

      - `:agent`

    - `version: Integer`

  - `created_at: Time`

    A timestamp in RFC 3339 format

  - `deployment_id: String`

    ID of the deployment that produced this run.

  - `error: BetaManagedAgentsEnvironmentArchivedRunError | BetaManagedAgentsAgentArchivedRunError | BetaManagedAgentsEnvironmentNotFoundRunError | 13 more`

    Why the run failed to create a session. The type identifies the failure; message is human-readable detail.

    - `class BetaManagedAgentsEnvironmentArchivedRunError`

      The deployment's environment was archived.

      - `message: String`

        Human-readable error description.

      - `type: :environment_archived_error`

        - `:environment_archived_error`

    - `class BetaManagedAgentsAgentArchivedRunError`

      The deployment's agent was archived.

      - `message: String`

        Human-readable error description.

      - `type: :agent_archived_error`

        - `:agent_archived_error`

    - `class BetaManagedAgentsEnvironmentNotFoundRunError`

      The deployment's environment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :environment_not_found_error`

        - `:environment_not_found_error`

    - `class BetaManagedAgentsVaultNotFoundRunError`

      A vault referenced by the deployment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :vault_not_found_error`

        - `:vault_not_found_error`

    - `class BetaManagedAgentsVaultArchivedRunError`

      A vault referenced by the deployment is archived.

      - `message: String`

        Human-readable error description.

      - `type: :vault_archived_error`

        - `:vault_archived_error`

    - `class BetaManagedAgentsFileNotFoundRunError`

      A file resource referenced by the deployment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :file_not_found_error`

        - `:file_not_found_error`

    - `class BetaManagedAgentsMemoryStoreArchivedRunError`

      A memory store referenced by the deployment is archived.

      - `message: String`

        Human-readable error description.

      - `type: :memory_store_archived_error`

        - `:memory_store_archived_error`

    - `class BetaManagedAgentsSkillNotFoundRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :skill_not_found_error`

        - `:skill_not_found_error`

    - `class BetaManagedAgentsSessionResourceNotFoundRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :session_resource_not_found_error`

        - `:session_resource_not_found_error`

    - `class BetaManagedAgentsWorkspaceArchivedRunError`

      The deployment's workspace was archived.

      - `message: String`

        Human-readable error description.

      - `type: :workspace_archived_error`

        - `:workspace_archived_error`

    - `class BetaManagedAgentsOrganizationDisabledRunError`

      The deployment's organization is disabled.

      - `message: String`

        Human-readable error description.

      - `type: :organization_disabled_error`

        - `:organization_disabled_error`

    - `class BetaManagedAgentsSessionRateLimitedRunError`

      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`

        - `:session_rate_limited_error`

    - `class BetaManagedAgentsSessionCreationRejectedRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :session_creation_rejected_error`

        - `:session_creation_rejected_error`

    - `class BetaManagedAgentsUnknownRunError`

      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`

        - `:unknown_error`

    - `class BetaManagedAgentsSelfHostedResourcesUnsupportedRunError`

      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`

        - `:self_hosted_resources_unsupported_error`

    - `class BetaManagedAgentsMCPEgressBlockedRunError`

      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`

        - `:mcp_egress_blocked_error`

  - `session_id: String`

    Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.

  - `trigger_context: BetaManagedAgentsTriggerContext`

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

    - `class BetaManagedAgentsScheduleTriggerContext`

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

      - `scheduled_at: Time`

        A timestamp in RFC 3339 format

      - `type: :schedule`

        - `:schedule`

    - `class BetaManagedAgentsManualTriggerContext`

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

      - `type: :manual`

        - `:manual`

  - `type: :deployment_run`

    - `:deployment_run`

### Example

```ruby
require "anthropic"

anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")

page = anthropic.beta.deployment_runs.list

puts(page)
```

#### Response

```json
{
  "data": [
    {
      "id": "id",
      "agent": {
        "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
        "type": "agent",
        "version": 1
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "deployment_id": "deployment_id",
      "error": {
        "message": "message",
        "type": "environment_archived_error"
      },
      "session_id": "session_id",
      "trigger_context": {
        "scheduled_at": "2019-12-27T18:11:19.117Z",
        "type": "schedule"
      },
      "type": "deployment_run"
    }
  ],
  "next_page": "next_page"
}
```

## Get Deployment Run

`beta.deployment_runs.retrieve(deployment_run_id, **kwargs) -> BetaManagedAgentsDeploymentRun`

**get** `/v1/deployment_runs/{deployment_run_id}`

Get Deployment Run

### Parameters

- `deployment_run_id: String`

- `betas: Array[AnthropicBeta]`

  Optional header to specify the beta version(s) you want to use.

  - `String = String`

  - `AnthropicBeta = :"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 25 more`

    - `:"message-batches-2024-09-24"`

    - `:"prompt-caching-2024-07-31"`

    - `:"computer-use-2024-10-22"`

    - `:"computer-use-2025-01-24"`

    - `:"pdfs-2024-09-25"`

    - `:"token-counting-2024-11-01"`

    - `:"token-efficient-tools-2025-02-19"`

    - `:"output-128k-2025-02-19"`

    - `:"files-api-2025-04-14"`

    - `:"mcp-client-2025-04-04"`

    - `:"mcp-client-2025-11-20"`

    - `:"dev-full-thinking-2025-05-14"`

    - `:"interleaved-thinking-2025-05-14"`

    - `:"code-execution-2025-05-22"`

    - `:"extended-cache-ttl-2025-04-11"`

    - `:"context-1m-2025-08-07"`

    - `:"context-management-2025-06-27"`

    - `:"model-context-window-exceeded-2025-08-26"`

    - `:"skills-2025-10-02"`

    - `:"fast-mode-2026-02-01"`

    - `:"output-300k-2026-03-24"`

    - `:"user-profiles-2026-03-24"`

    - `:"advisor-tool-2026-03-01"`

    - `:"managed-agents-2026-04-01"`

    - `:"cache-diagnosis-2026-04-07"`

    - `:"thinking-token-count-2026-05-13"`

    - `:"server-side-fallback-2026-06-01"`

    - `:"fallback-credit-2026-06-01"`

### Returns

- `class BetaManagedAgentsDeploymentRun`

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

  - `id: String`

    Unique identifier for this run (`drun_...`).

  - `agent: BetaManagedAgentsAgentReference`

    A resolved agent reference with a concrete version.

    - `id: String`

    - `type: :agent`

      - `:agent`

    - `version: Integer`

  - `created_at: Time`

    A timestamp in RFC 3339 format

  - `deployment_id: String`

    ID of the deployment that produced this run.

  - `error: BetaManagedAgentsEnvironmentArchivedRunError | BetaManagedAgentsAgentArchivedRunError | BetaManagedAgentsEnvironmentNotFoundRunError | 13 more`

    Why the run failed to create a session. The type identifies the failure; message is human-readable detail.

    - `class BetaManagedAgentsEnvironmentArchivedRunError`

      The deployment's environment was archived.

      - `message: String`

        Human-readable error description.

      - `type: :environment_archived_error`

        - `:environment_archived_error`

    - `class BetaManagedAgentsAgentArchivedRunError`

      The deployment's agent was archived.

      - `message: String`

        Human-readable error description.

      - `type: :agent_archived_error`

        - `:agent_archived_error`

    - `class BetaManagedAgentsEnvironmentNotFoundRunError`

      The deployment's environment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :environment_not_found_error`

        - `:environment_not_found_error`

    - `class BetaManagedAgentsVaultNotFoundRunError`

      A vault referenced by the deployment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :vault_not_found_error`

        - `:vault_not_found_error`

    - `class BetaManagedAgentsVaultArchivedRunError`

      A vault referenced by the deployment is archived.

      - `message: String`

        Human-readable error description.

      - `type: :vault_archived_error`

        - `:vault_archived_error`

    - `class BetaManagedAgentsFileNotFoundRunError`

      A file resource referenced by the deployment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :file_not_found_error`

        - `:file_not_found_error`

    - `class BetaManagedAgentsMemoryStoreArchivedRunError`

      A memory store referenced by the deployment is archived.

      - `message: String`

        Human-readable error description.

      - `type: :memory_store_archived_error`

        - `:memory_store_archived_error`

    - `class BetaManagedAgentsSkillNotFoundRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :skill_not_found_error`

        - `:skill_not_found_error`

    - `class BetaManagedAgentsSessionResourceNotFoundRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :session_resource_not_found_error`

        - `:session_resource_not_found_error`

    - `class BetaManagedAgentsWorkspaceArchivedRunError`

      The deployment's workspace was archived.

      - `message: String`

        Human-readable error description.

      - `type: :workspace_archived_error`

        - `:workspace_archived_error`

    - `class BetaManagedAgentsOrganizationDisabledRunError`

      The deployment's organization is disabled.

      - `message: String`

        Human-readable error description.

      - `type: :organization_disabled_error`

        - `:organization_disabled_error`

    - `class BetaManagedAgentsSessionRateLimitedRunError`

      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`

        - `:session_rate_limited_error`

    - `class BetaManagedAgentsSessionCreationRejectedRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :session_creation_rejected_error`

        - `:session_creation_rejected_error`

    - `class BetaManagedAgentsUnknownRunError`

      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`

        - `:unknown_error`

    - `class BetaManagedAgentsSelfHostedResourcesUnsupportedRunError`

      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`

        - `:self_hosted_resources_unsupported_error`

    - `class BetaManagedAgentsMCPEgressBlockedRunError`

      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`

        - `:mcp_egress_blocked_error`

  - `session_id: String`

    Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.

  - `trigger_context: BetaManagedAgentsTriggerContext`

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

    - `class BetaManagedAgentsScheduleTriggerContext`

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

      - `scheduled_at: Time`

        A timestamp in RFC 3339 format

      - `type: :schedule`

        - `:schedule`

    - `class BetaManagedAgentsManualTriggerContext`

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

      - `type: :manual`

        - `:manual`

  - `type: :deployment_run`

    - `:deployment_run`

### Example

```ruby
require "anthropic"

anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")

beta_managed_agents_deployment_run = anthropic.beta.deployment_runs.retrieve("deployment_run_id")

puts(beta_managed_agents_deployment_run)
```

#### Response

```json
{
  "id": "id",
  "agent": {
    "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
    "type": "agent",
    "version": 1
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "deployment_id": "deployment_id",
  "error": {
    "message": "message",
    "type": "environment_archived_error"
  },
  "session_id": "session_id",
  "trigger_context": {
    "scheduled_at": "2019-12-27T18:11:19.117Z",
    "type": "schedule"
  },
  "type": "deployment_run"
}
```

## Domain Types

### Beta Managed Agents Agent Archived Run Error

- `class BetaManagedAgentsAgentArchivedRunError`

  The deployment's agent was archived.

  - `message: String`

    Human-readable error description.

  - `type: :agent_archived_error`

    - `:agent_archived_error`

### Beta Managed Agents Deployment Run

- `class BetaManagedAgentsDeploymentRun`

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

  - `id: String`

    Unique identifier for this run (`drun_...`).

  - `agent: BetaManagedAgentsAgentReference`

    A resolved agent reference with a concrete version.

    - `id: String`

    - `type: :agent`

      - `:agent`

    - `version: Integer`

  - `created_at: Time`

    A timestamp in RFC 3339 format

  - `deployment_id: String`

    ID of the deployment that produced this run.

  - `error: BetaManagedAgentsEnvironmentArchivedRunError | BetaManagedAgentsAgentArchivedRunError | BetaManagedAgentsEnvironmentNotFoundRunError | 13 more`

    Why the run failed to create a session. The type identifies the failure; message is human-readable detail.

    - `class BetaManagedAgentsEnvironmentArchivedRunError`

      The deployment's environment was archived.

      - `message: String`

        Human-readable error description.

      - `type: :environment_archived_error`

        - `:environment_archived_error`

    - `class BetaManagedAgentsAgentArchivedRunError`

      The deployment's agent was archived.

      - `message: String`

        Human-readable error description.

      - `type: :agent_archived_error`

        - `:agent_archived_error`

    - `class BetaManagedAgentsEnvironmentNotFoundRunError`

      The deployment's environment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :environment_not_found_error`

        - `:environment_not_found_error`

    - `class BetaManagedAgentsVaultNotFoundRunError`

      A vault referenced by the deployment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :vault_not_found_error`

        - `:vault_not_found_error`

    - `class BetaManagedAgentsVaultArchivedRunError`

      A vault referenced by the deployment is archived.

      - `message: String`

        Human-readable error description.

      - `type: :vault_archived_error`

        - `:vault_archived_error`

    - `class BetaManagedAgentsFileNotFoundRunError`

      A file resource referenced by the deployment no longer exists.

      - `message: String`

        Human-readable error description.

      - `type: :file_not_found_error`

        - `:file_not_found_error`

    - `class BetaManagedAgentsMemoryStoreArchivedRunError`

      A memory store referenced by the deployment is archived.

      - `message: String`

        Human-readable error description.

      - `type: :memory_store_archived_error`

        - `:memory_store_archived_error`

    - `class BetaManagedAgentsSkillNotFoundRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :skill_not_found_error`

        - `:skill_not_found_error`

    - `class BetaManagedAgentsSessionResourceNotFoundRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :session_resource_not_found_error`

        - `:session_resource_not_found_error`

    - `class BetaManagedAgentsWorkspaceArchivedRunError`

      The deployment's workspace was archived.

      - `message: String`

        Human-readable error description.

      - `type: :workspace_archived_error`

        - `:workspace_archived_error`

    - `class BetaManagedAgentsOrganizationDisabledRunError`

      The deployment's organization is disabled.

      - `message: String`

        Human-readable error description.

      - `type: :organization_disabled_error`

        - `:organization_disabled_error`

    - `class BetaManagedAgentsSessionRateLimitedRunError`

      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`

        - `:session_rate_limited_error`

    - `class BetaManagedAgentsSessionCreationRejectedRunError`

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

      - `message: String`

        Human-readable error description.

      - `type: :session_creation_rejected_error`

        - `:session_creation_rejected_error`

    - `class BetaManagedAgentsUnknownRunError`

      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`

        - `:unknown_error`

    - `class BetaManagedAgentsSelfHostedResourcesUnsupportedRunError`

      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`

        - `:self_hosted_resources_unsupported_error`

    - `class BetaManagedAgentsMCPEgressBlockedRunError`

      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`

        - `:mcp_egress_blocked_error`

  - `session_id: String`

    Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.

  - `trigger_context: BetaManagedAgentsTriggerContext`

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

    - `class BetaManagedAgentsScheduleTriggerContext`

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

      - `scheduled_at: Time`

        A timestamp in RFC 3339 format

      - `type: :schedule`

        - `:schedule`

    - `class BetaManagedAgentsManualTriggerContext`

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

      - `type: :manual`

        - `:manual`

  - `type: :deployment_run`

    - `:deployment_run`

### Beta Managed Agents Environment Archived Run Error

- `class BetaManagedAgentsEnvironmentArchivedRunError`

  The deployment's environment was archived.

  - `message: String`

    Human-readable error description.

  - `type: :environment_archived_error`

    - `:environment_archived_error`

### Beta Managed Agents Environment Not Found Run Error

- `class BetaManagedAgentsEnvironmentNotFoundRunError`

  The deployment's environment no longer exists.

  - `message: String`

    Human-readable error description.

  - `type: :environment_not_found_error`

    - `:environment_not_found_error`

### Beta Managed Agents File Not Found Run Error

- `class BetaManagedAgentsFileNotFoundRunError`

  A file resource referenced by the deployment no longer exists.

  - `message: String`

    Human-readable error description.

  - `type: :file_not_found_error`

    - `:file_not_found_error`

### Beta Managed Agents Manual Trigger Context

- `class BetaManagedAgentsManualTriggerContext`

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

  - `type: :manual`

    - `:manual`

### Beta Managed Agents MCP Egress Blocked Run Error

- `class BetaManagedAgentsMCPEgressBlockedRunError`

  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`

    - `:mcp_egress_blocked_error`

### Beta Managed Agents Memory Store Archived Run Error

- `class BetaManagedAgentsMemoryStoreArchivedRunError`

  A memory store referenced by the deployment is archived.

  - `message: String`

    Human-readable error description.

  - `type: :memory_store_archived_error`

    - `:memory_store_archived_error`

### Beta Managed Agents Organization Disabled Run Error

- `class BetaManagedAgentsOrganizationDisabledRunError`

  The deployment's organization is disabled.

  - `message: String`

    Human-readable error description.

  - `type: :organization_disabled_error`

    - `:organization_disabled_error`

### Beta Managed Agents Schedule Trigger Context

- `class BetaManagedAgentsScheduleTriggerContext`

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

  - `scheduled_at: Time`

    A timestamp in RFC 3339 format

  - `type: :schedule`

    - `:schedule`

### Beta Managed Agents Self Hosted Resources Unsupported Run Error

- `class BetaManagedAgentsSelfHostedResourcesUnsupportedRunError`

  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`

    - `:self_hosted_resources_unsupported_error`

### Beta Managed Agents Session Creation Rejected Run Error

- `class BetaManagedAgentsSessionCreationRejectedRunError`

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

  - `message: String`

    Human-readable error description.

  - `type: :session_creation_rejected_error`

    - `:session_creation_rejected_error`

### Beta Managed Agents Session Rate Limited Run Error

- `class BetaManagedAgentsSessionRateLimitedRunError`

  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`

    - `:session_rate_limited_error`

### Beta Managed Agents Session Resource Not Found Run Error

- `class BetaManagedAgentsSessionResourceNotFoundRunError`

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

  - `message: String`

    Human-readable error description.

  - `type: :session_resource_not_found_error`

    - `:session_resource_not_found_error`

### Beta Managed Agents Skill Not Found Run Error

- `class BetaManagedAgentsSkillNotFoundRunError`

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

  - `message: String`

    Human-readable error description.

  - `type: :skill_not_found_error`

    - `:skill_not_found_error`

### Beta Managed Agents Trigger Context

- `BetaManagedAgentsTriggerContext = BetaManagedAgentsScheduleTriggerContext | BetaManagedAgentsManualTriggerContext`

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

  - `class BetaManagedAgentsScheduleTriggerContext`

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

    - `scheduled_at: Time`

      A timestamp in RFC 3339 format

    - `type: :schedule`

      - `:schedule`

  - `class BetaManagedAgentsManualTriggerContext`

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

    - `type: :manual`

      - `:manual`

### Beta Managed Agents Trigger Type

- `BetaManagedAgentsTriggerType = :schedule | :manual`

  What triggered a deployment run.

  - `:schedule`

  - `:manual`

### Beta Managed Agents Unknown Run Error

- `class BetaManagedAgentsUnknownRunError`

  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`

    - `:unknown_error`

### Beta Managed Agents Vault Archived Run Error

- `class BetaManagedAgentsVaultArchivedRunError`

  A vault referenced by the deployment is archived.

  - `message: String`

    Human-readable error description.

  - `type: :vault_archived_error`

    - `:vault_archived_error`

### Beta Managed Agents Vault Not Found Run Error

- `class BetaManagedAgentsVaultNotFoundRunError`

  A vault referenced by the deployment no longer exists.

  - `message: String`

    Human-readable error description.

  - `type: :vault_not_found_error`

    - `:vault_not_found_error`

### Beta Managed Agents Workspace Archived Run Error

- `class BetaManagedAgentsWorkspaceArchivedRunError`

  The deployment's workspace was archived.

  - `message: String`

    Human-readable error description.

  - `type: :workspace_archived_error`

    - `:workspace_archived_error`
