# Get deployment

**GET /api/v1/projects/{id}/deployments/{deployment_id}**

Proxies to ECP to retrieve a single deployment by ID with field transformations (e.g. pending -> queued). The project scope is carried by the route id path parameter and the org is derived from that project.


## Servers
- https://agentengine.mongodb.com: https://agentengine.mongodb.com ()


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **id** (string)
  Project ID

- **deployment_id** (string)
  Deployment ID




## Responses
### 406
Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

#### Body: application/json (object)
- **badRequestDetail** (object)
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

- **detail** (string)
  Human-readable error details.

- **error** (integer)
  HTTP status code.

- **errorCode** (string)
  Machine-readable error code.

- **parameters** (array[string])
  Request parameter names associated with the error; omitted when none apply.

- **reason** (string)
  HTTP status reason phrase.


### 200
OK

#### Body: application/json (object)
- **aer_http_endpoint** (string)
  AERHTTPEndpoint is the legacy name of the agent sandbox HTTP endpoint.

- **agent_http_endpoint** (string)
  AgentHTTPEndpoint is the agent sandbox HTTP endpoint. Same value as aer_http_endpoint.

- **agent_stack_name** (string)

- **app_id** (string)

- **branch** (string)

- **build_id** (string)

- **commit_sha** (string)

- **completed_at** (string)

- **component_images** (object)

- **components** (array[object])
  Per-component health — forwarded as-is from ECP for the detail view.

- **conditions** (array[object])

- **created_at** (string)
  Timestamps.

- **deployment_id** (string)
  Identity & core status (always present).

- **duration_ms** (integer)

- **error_message** (string)
  Failure context — surfaced so admin UIs can triage without going to Splunk first.

- **executor_type** (string)

- **first_deploy** (boolean)
  FirstDeploy is true for every attempt until (and including) the
  workspace's first successful deploy. Omitted when unknown.

- **health** (object)
  Extended fields.

- **image_uri** (string)
  Image / source.

- **language** (string)
  Language is the agent runtime language ("python" | "typescript"), forwarded
  from ECP. Omitted when unset (older builds default to python downstream).

- **last_event_seq** (integer)

- **memory_enabled** (boolean)
  MemoryEnabled is the deployment's effective runtime memory setting. Omitted when unavailable.

- **missing_secrets** (array[string])

- **operator_namespace** (string)

- **org_id** (string)

- **post_deploy_error_message** (string)

- **previous_image_uri** (string)

- **project_deleted** (boolean)
  True when the deployment's owning project has been soft-deleted.
  Always emitted so consumers can branch on the field, not its absence.

- **project_id** (string)

- **release_number** (integer)
  ReleaseNumber is the per-workspace monotonic version identifier
  (drives the v{N} label in the UI). 0/omitted for legacy records
  before the backfill migration.

- **requested_images** (array[object])
  RequestedImages is digest-pinned deploy intent. Omitted for legacy
  deployments created before image digest tracking was enabled;
  [] means the writer ran but resolved nothing.

- **requested_target_id** (string)
  RequestedTargetID is internal Fleet provenance and is intentionally not
  surfaced by Gateway responses. It remains empty for compatibility.

- **rollback_error** (string)

- **rollback_from_id** (string)
  set when this deployment was rolled back *from*

- **rollback_of** (string)
  Rollback linkage.

- **shipped_in_release** (string)
  ShippedInRelease is the release that shipped this deployment. Omitted
  when it belongs to none. Forwarded from ECP; derived at read time.

- **source_build_id** (string)

- **source_project_id** (string)

- **source_promotion_id** (string)

- **source_workspace_id** (string)

- **started_at** (string)

- **status** (string)

- **target_namespace** (string)
  Kubernetes placement.

- **trigger** (string)

- **updated_at** (string)

- **version** (string)
  Version is the developer-declared agent version forwarded from ECP.
  Omitted for unversioned records.


### 400
Bad Request

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 403
Forbidden

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 502
Bad Gateway

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)



[Powered by Bump.sh](https://bump.sh)