---
title: "Changes to ListDeployments lists deployments for a project."
method: GET
path: "/v1/orgs/{org}/projects/{project}/deployments"
---

# Changes to ListDeployments lists deployments for a project.

`GET /v1/orgs/{org}/projects/{project}/deployments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 70 revisions.

- **2026-10-16** (v1) `5c48f840fcc4`: 1 info
- **2026-05-06** (v1) `0aeb660cd27f`: 1 info
- **2025-12-23** (v1) `5018914f099f`: 1 info
- **2025-12-11** (v1) `431878c7e255`: 1 info
- **2025-11-24** (v1) `f58ec6956f04`: 6 warning, 2 info

## Changes

- **2026-10-16** (v1) `5c48f840fcc4`: 1 info
  - added the new optional `query` request parameter `superuserForceAccess`
- **2026-05-06** (v1) `0aeb660cd27f`: 1 info
  - added the optional property `deployments/items/usedOn` to the response with the `200` status
- **2025-12-23** (v1) `5018914f099f`: 1 info
  - added the new optional `query` request parameter `branch`
- **2025-12-11** (v1) `431878c7e255`: 1 info
  - added the optional property `deployments/items/editable` to the response with the `200` status
- **2025-11-24** (v1) `f58ec6956f04`: 6 warning, 2 info
  - added the new `DEPLOYMENT_STATUS_DELETED` enum value to the `deployments/items/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_DELETING` enum value to the `deployments/items/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_ERRORED` enum value to the `deployments/items/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_RUNNING` enum value to the `deployments/items/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_STOPPING` enum value to the `deployments/items/status` response property for the response status `200`
  - added the new `DEPLOYMENT_STATUS_UPDATING` enum value to the `deployments/items/status` response property for the response status `200`
  - removed the `DEPLOYMENT_STATUS_ERROR` enum value from the `deployments/items/status` response property for the response status `200`
  - removed the `DEPLOYMENT_STATUS_OK` enum value from the `deployments/items/status` response property for the response status `200`

---

[Operation](https://skmtc.dev/rilldata/apis/rill-admin-api/docs/v1/orgs/:org/projects/:project/deployments/get.md) - [API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) - [Page](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/projects/:project/deployments/get)