# List workspace deployments

**GET /api/v1/projects/{id}/workspaces/{workspace_id}/deployments**

Proxies to ECP to list deployments for a workspace with cursor-based pagination and optional status filter. 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

- **workspace_id** (string)
  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
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)
- **deployments** (array[object])

- **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
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)