GET /api/v1/projects/{id}/deployments/{deployment_id}
Bearer auth

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.

Path parameters

  • id string Required

    Project ID

  • deployment_id string Required

    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.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.
  • 200

    OK

    Hide response attributes Show response attributes 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
      Hide component_images attributes Show component_images attributes object
      • aer string

        AER is the legacy name of the agent sandbox image.

      • agent string

        Agent is the agent sandbox image. Same value as aer.

      • memory_server string
      • oe string
      • tool string
    • components array[object]

      Per-component health — forwarded as-is from ECP for the detail view.

      Hide components attributes Show components attributes object
      • available boolean
      • failure_message string
      • failure_reason string
      • name string
      • ready_replicas integer
      • replicas integer

        Replicas is the desired pod count. Zero means the platform has not reported one; consumers must not treat zero as scale-to-zero.

      • sandbox string

        Sandbox is the canonical sandbox name for known component values (agent, tool). Omitted for unknown upstream names.

      • type string
    • conditions array[object]
      Hide conditions attributes Show conditions attributes object
      • last_transition_time string
      • message string
      • reason string
      • status string
      • type string
    • 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.

      Hide health attributes Show health attributes object
      • available boolean
      • checked_at string
      • components array[object]
        Hide components attributes Show components attributes object
        • name string
        • ready boolean
        • ready_replicas integer
        • sandbox string

          Sandbox is the canonical sandbox name for known component values (agent, tool). Omitted for unknown upstream names.

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

      Hide requested_images attributes Show requested_images attributes object
      • component string
      • digest string
      • sandbox string

        Sandbox is the canonical sandbox name for known component values. Omitted for unknown upstream names.

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

    Hide response attributes Show response attributes 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
      Hide component_images attributes Show component_images attributes object
      • aer string

        AER is the legacy name of the agent sandbox image.

      • agent string

        Agent is the agent sandbox image. Same value as aer.

      • memory_server string
      • oe string
      • tool string
    • components array[object]

      Per-component health — forwarded as-is from ECP for the detail view.

      Hide components attributes Show components attributes object
      • available boolean
      • failure_message string
      • failure_reason string
      • name string
      • ready_replicas integer
      • replicas integer

        Replicas is the desired pod count. Zero means the platform has not reported one; consumers must not treat zero as scale-to-zero.

      • sandbox string

        Sandbox is the canonical sandbox name for known component values (agent, tool). Omitted for unknown upstream names.

      • type string
    • conditions array[object]
      Hide conditions attributes Show conditions attributes object
      • last_transition_time string
      • message string
      • reason string
      • status string
      • type string
    • 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.

      Hide health attributes Show health attributes object
      • available boolean
      • checked_at string
      • components array[object]
        Hide components attributes Show components attributes object
        • name string
        • ready boolean
        • ready_replicas integer
        • sandbox string

          Sandbox is the canonical sandbox name for known component values (agent, tool). Omitted for unknown upstream names.

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

      Hide requested_images attributes Show requested_images attributes object
      • component string
      • digest string
      • sandbox string

        Sandbox is the canonical sandbox name for known component values. Omitted for unknown upstream names.

    • 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

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 403

    Forbidden

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 502

    Bad Gateway

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
GET /api/v1/projects/{id}/deployments/{deployment_id} 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/deployments/{deployment_id}' \
 --header "Authorization: $API_KEY"
Response examples (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Response examples (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Response examples (200) 
{
  "aer_http_endpoint": "string",
  "agent_http_endpoint": "string",
  "agent_stack_name": "string",
  "app_id": "string",
  "branch": "string",
  "build_id": "string",
  "commit_sha": "string",
  "completed_at": "string",
  "component_images": {
    "aer": "string",
    "agent": "string",
    "memory_server": "string",
    "oe": "string",
    "tool": "string"
  },
  "components": [
    {
      "available": true,
      "failure_message": "string",
      "failure_reason": "string",
      "name": "string",
      "ready_replicas": 42,
      "replicas": 42,
      "sandbox": "string",
      "type": "string"
    }
  ],
  "conditions": [
    {
      "last_transition_time": "string",
      "message": "string",
      "reason": "string",
      "status": "string",
      "type": "string"
    }
  ],
  "created_at": "string",
  "deployment_id": "string",
  "duration_ms": 42,
  "error_message": "string",
  "executor_type": "string",
  "first_deploy": true,
  "health": {
    "available": true,
    "checked_at": "string",
    "components": [
      {
        "name": "string",
        "ready": true,
        "ready_replicas": 42,
        "sandbox": "string"
      }
    ]
  },
  "image_uri": "string",
  "language": "string",
  "last_event_seq": 42,
  "memory_enabled": true,
  "missing_secrets": [
    "string"
  ],
  "operator_namespace": "string",
  "org_id": "string",
  "post_deploy_error_message": "string",
  "previous_image_uri": "string",
  "project_deleted": true,
  "project_id": "string",
  "release_number": 42,
  "requested_images": [
    {
      "component": "string",
      "digest": "string",
      "sandbox": "string"
    }
  ],
  "requested_target_id": "string",
  "rollback_error": "string",
  "rollback_from_id": "string",
  "rollback_of": "string",
  "shipped_in_release": "string",
  "source_build_id": "string",
  "source_project_id": "string",
  "source_promotion_id": "string",
  "source_workspace_id": "string",
  "started_at": "string",
  "status": "string",
  "target_namespace": "string",
  "trigger": "string",
  "updated_at": "string",
  "version": "string"
}
Response examples (200) 
{
  "aer_http_endpoint": "string",
  "agent_http_endpoint": "string",
  "agent_stack_name": "string",
  "app_id": "string",
  "branch": "string",
  "build_id": "string",
  "commit_sha": "string",
  "completed_at": "string",
  "component_images": {
    "aer": "string",
    "agent": "string",
    "memory_server": "string",
    "oe": "string",
    "tool": "string"
  },
  "components": [
    {
      "available": true,
      "failure_message": "string",
      "failure_reason": "string",
      "name": "string",
      "ready_replicas": 42,
      "replicas": 42,
      "sandbox": "string",
      "type": "string"
    }
  ],
  "conditions": [
    {
      "last_transition_time": "string",
      "message": "string",
      "reason": "string",
      "status": "string",
      "type": "string"
    }
  ],
  "created_at": "string",
  "deployment_id": "string",
  "duration_ms": 42,
  "error_message": "string",
  "executor_type": "string",
  "first_deploy": true,
  "health": {
    "available": true,
    "checked_at": "string",
    "components": [
      {
        "name": "string",
        "ready": true,
        "ready_replicas": 42,
        "sandbox": "string"
      }
    ]
  },
  "image_uri": "string",
  "language": "string",
  "last_event_seq": 42,
  "memory_enabled": true,
  "missing_secrets": [
    "string"
  ],
  "operator_namespace": "string",
  "org_id": "string",
  "post_deploy_error_message": "string",
  "previous_image_uri": "string",
  "project_deleted": true,
  "project_id": "string",
  "release_number": 42,
  "requested_images": [
    {
      "component": "string",
      "digest": "string",
      "sandbox": "string"
    }
  ],
  "requested_target_id": "string",
  "rollback_error": "string",
  "rollback_from_id": "string",
  "rollback_of": "string",
  "shipped_in_release": "string",
  "source_build_id": "string",
  "source_project_id": "string",
  "source_promotion_id": "string",
  "source_workspace_id": "string",
  "started_at": "string",
  "status": "string",
  "target_namespace": "string",
  "trigger": "string",
  "updated_at": "string",
  "version": "string"
}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}