Path parameters

• id string Required

  Project ID

• workspace_id string Required

  Workspace ID

Query parameters

• cursor string

  Opaque pagination cursor

• limit integer

  Page size (1-100, default 20)

• status string

  Deployment status filter (queued, in_progress, cleaning_up, succeeded, failed, rolled_back, cancelled)

• shipped_in_release string

  Return the deployments that shipped in this release: its own artifact deploys plus the non-release deploys that landed before its cut. Rollbacks are excluded.

Responses

• 406

  application/json

  application/json application/vnd.agent-engine-2026-09-20-preview+json

  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

  application/vnd.agent-engine-2026-09-20-preview+json

  application/vnd.agent-engine-2026-09-20-preview+json application/json

  OK

  Hide response attributes Show response attributes object

  • deployments array[object]
    Hide deployments attributes Show deployments 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.

  • limit integer

    Set by the offset-paginated platform-wide admin list. Per-workspace endpoints leave these zero-valued and they are omitted on the wire.

  • next_cursor string

    Set by the cursor-paginated per-workspace admin list. Platform-wide endpoints leave it nil.

  • offset integer
  • total integer
  Hide response attributes Show response attributes object

  • deployments array[object]
    Hide deployments attributes Show deployments 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.

  • limit integer

    Set by the offset-paginated platform-wide admin list. Per-workspace endpoints leave these zero-valued and they are omitted on the wire.

  • next_cursor string

    Set by the cursor-paginated per-workspace admin list. Platform-wide endpoints leave it nil.

  • offset integer
  • total integer
• 400

  application/json

  application/json application/vnd.agent-engine-2026-09-20-preview+json

  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

  application/json

  application/json application/vnd.agent-engine-2026-09-20-preview+json

  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

  application/json

  application/json application/vnd.agent-engine-2026-09-20-preview+json

  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