---
title: "Get Deployment Run"
method: GET
path: "/v1/deployment_runs/{deployment_run_id}?beta=true"
---

# Get Deployment Run

`GET /v1/deployment_runs/{deployment_run_id}?beta=true`

## Path parameters

- `deployment_run_id` string, required

## Headers

- `x-api-key` string
- `anthropic-version` string
- `anthropic-beta` string

## Response `200`

Successful response (OK)

- BetaManagedAgentsDeploymentRun — A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.
  - `type` 'deployment_run', required
  - `id` string, required — Unique identifier for this run (`drun_...`).
  - `deployment_id` string, required — ID of the deployment that produced this run.
  - `trigger_context` union, required — Describes what triggered a deployment run, with trigger-specific metadata.
    - object — The run was fired by the deployment's cron schedule.
      - `type` 'schedule', required
      - `scheduled_at` string, date-time, required — A timestamp in RFC 3339 format
    - object — The run was started manually by creating a session directly against the deployment.
      - `type` 'manual', required
  - `session_id` string, nullable, required — Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.
  - `error` union, required — Why the run failed to create a session. The type identifies the failure; message is human-readable detail.
    - object — The deployment's environment was archived.
      - `type` 'environment_archived_error', required
      - `message` string, required — Human-readable error description.
    - object — The deployment's agent was archived.
      - `type` 'agent_archived_error', required
      - `message` string, required — Human-readable error description.
    - object — The deployment's environment no longer exists.
      - `type` 'environment_not_found_error', required
      - `message` string, required — Human-readable error description.
    - object — A vault referenced by the deployment no longer exists.
      - `type` 'vault_not_found_error', required
      - `message` string, required — Human-readable error description.
    - object — A vault referenced by the deployment is archived.
      - `type` 'vault_archived_error', required
      - `message` string, required — Human-readable error description.
    - object — A file resource referenced by the deployment no longer exists.
      - `type` 'file_not_found_error', required
      - `message` string, required — Human-readable error description.
    - object — A memory store referenced by the deployment is archived.
      - `type` 'memory_store_archived_error', required
      - `message` string, required — Human-readable error description.
    - object — A skill referenced by the deployment's agent no longer exists.
      - `type` 'skill_not_found_error', required
      - `message` string, required — Human-readable error description.
    - object — A referenced resource no longer exists and its kind was not reported.
      - `type` 'session_resource_not_found_error', required
      - `message` string, required — Human-readable error description.
    - object — The deployment's workspace was archived.
      - `type` 'workspace_archived_error', required
      - `message` string, required — Human-readable error description.
    - object — The deployment's organization is disabled.
      - `type` 'organization_disabled_error', required
      - `message` string, required — Human-readable error description.
    - object — Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
      - `type` 'session_rate_limited_error', required
      - `message` string, required — Human-readable error description.
    - object — The session create request was rejected with a non-retryable validation error.
      - `type` 'session_creation_rejected_error', required
      - `message` string, required — Human-readable error description.
    - object — 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.
      - `type` 'unknown_error', required
      - `message` string, required — Human-readable error description.
    - object — The deployment configures resources, but its environment is self-hosted and cannot mount them.
      - `type` 'self_hosted_resources_unsupported_error', required
      - `message` string, required — Human-readable error description.
    - object — An MCP server host used by the deployment's agent is blocked by the environment's network policy.
      - `type` 'mcp_egress_blocked_error', required
      - `message` string, required — Human-readable error description.
  - `agent` BetaManagedAgentsAgentReference, required — A resolved agent reference with a concrete version.
    - `type` 'agent', required
    - `id` string, required
    - `version` integer, required
  - `created_at` string, date-time, required — A timestamp in RFC 3339 format

## Other responses

- `400` — Invalid argument - The client specified an invalid argument
- `401` — Unauthenticated - The request does not have valid authentication credentials
- `403` — Permission denied - The caller does not have permission to execute the specified operation
- `404` — Not found - Some requested entity was not found
- `408` — Deadline exceeded - The deadline expired before the operation could complete
- `409` — Aborted - The operation was aborted due to concurrency issue
- `412` — Failed precondition - Operation was rejected because the system is not in required state
- `413` — Out of range - Operation was attempted past the valid range
- `429` — Resource exhausted - Some resource has been exhausted (rate limiting)
- `431` — Request header fields too large - Request metadata was too large
- `499` — Cancelled - The operation was cancelled by the client
- `500` — Internal - Internal server error
- `501` — Unimplemented - The operation is not implemented or supported
- `503` — Unavailable - The service is currently unavailable
- `504` — Deadline exceeded - Upstream service did not respond in time

---

[API](https://skmtc.net/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.net/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anthropics/anthropic-api/versions/93d8fd7d6493/schema)