---
title: "Changes to List Deployments"
method: GET
path: "/v1/workflows/deployments"
---

# Changes to List Deployments

`GET /v1/workflows/deployments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 14 revisions.

- **2026-10-16** `0a8661df8379`: 2 warning
- **2026-10-15** `f42449e21ee5`: 2 info
- **2026-10-12** `6c349f3bdef6`: 4 breaking, 4 warning, 3 info
- **2026-09-23** `fa73befe1c61`: 17 info
- **2026-08-14** `61436a496404`: 6 info
- **2026-07-26** `933c4ebdcd72`: 1 warning, 4 info
- **2026-07-13** `5a5c361558bb`: 11 info
- **2026-04-07** `ff8a7389b7a4`: 1 info

## Changes

- **2026-10-16** `0a8661df8379`: 2 warning
  - deleted the `query` request parameter `dockerfile_path`
  - deleted the `query` request parameter `repository_url`
- **2026-10-15** `f42449e21ee5`: 2 info
  - added the new optional `query` request parameter `dockerfile_path`
  - added the new optional `query` request parameter `repository_url`
- **2026-10-12** `6c349f3bdef6`: 4 breaking, 4 warning, 3 info
  - added `#/components/schemas/DeploymentMistralCloudBackendSpec` to the `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/backend_spec` response property `oneOf` list for the response status `200`
  - removed the required property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/commit_sha` from the response with the `200` status
  - removed the required property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/entrypoint` from the response with the `200` status
  - removed the required property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/working_dir` from the response with the `200` status
  - removed the optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/resources/cpu_limit` from the response with the `200` status
  - removed the optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/resources/cpu_request` from the response with the `200` status
  - removed the optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/resources/memory_limit` from the response with the `200` status
  - removed the optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/resources/memory_request` from the response with the `200` status
  - added `mistral_cloud` discriminator mapping keys to the `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/backend_spec` response property for the response status `200`
  - mapped value for discriminator key `koyeb` changed from `#/components/schemas/DeploymentKoyebBackendSpec` to `#/components/schemas/DeploymentMistralCloudBackendSpec` for `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/backend_spec` response property for the response status `200`
  - removed `#/components/schemas/DeploymentKoyebBackendSpec` from the `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/backend_spec` response property `oneOf` list for the response status `200`
- **2026-09-23** `fa73befe1c61`: 17 info
  - added the new optional `query` request parameter `created_by`
  - added the new optional `query` request parameter `location_types`
  - added the new optional `query` request parameter `owner`
  - added the optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/runtime_credential_id` to the response with the `200` status
  - added the optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/runtime_principal_type` to the response with the `200` status
  - added the optional property `deployments/items/owner` to the response with the `200` status
  - the response optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/commit_sha` became read-only for the status `200`
  - the response optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/entrypoint` became read-only for the status `200`
  - the response optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/working_dir` became read-only for the status `200`
  - the response property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/commit_sha` became required for the status `200`
  - the response property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/entrypoint` became required for the status `200`
  - the response property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/working_dir` became required for the status `200`
  - response property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/entrypoint` deprecated
  - response property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/working_dir` deprecated
  - response property `deployments/items/updated_at` deprecated
  - added the required property `deployments/items/last_heartbeat` to the response with the `200` status
  - added the required property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/backend_spec` to the response with the `200` status
- **2026-08-14** `61436a496404`: 6 info
  - added the new optional `query` request parameter `order`
  - added the new optional `query` request parameter `order_by`
  - added the optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/is_hardened` to the response with the `200` status
  - added the optional property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/commit` to the response with the `200` status
  - response property `deployments/items/location` deprecated
  - response property `deployments/items/managed/anyOf[subschema #1: ManagedDeploymentResponse]/spec/commit_sha` deprecated
- **2026-07-26** `933c4ebdcd72`: 1 warning, 4 info
  - added the new `managed` enum value to the `deployments/items/location/anyOf[subschema #1: DeploymentLocation]/location_type` response property for the response status `200`
  - added the optional property `deployments/items/active_worker_count` to the response with the `200` status
  - added the optional property `deployments/items/locations` to the response with the `200` status
  - added the optional property `deployments/items/managed` to the response with the `200` status
  - added the optional property `deployments/items/worker_count` to the response with the `200` status
- **2026-07-13** `5a5c361558bb`: 11 info
  - api tag `workflows.deployments` added
  - api tag `beta.workflows.deployments` removed
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `is_hardened`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `search`
  - added the new optional `query` request parameter `workspace_id`
  - added the optional property `deployments/items/is_hardened` to the response with the `200` status
  - added the optional property `deployments/items/location` to the response with the `200` status
  - added the required property `next_cursor` to the response with the `200` status
  - added the required property `workspace_id` to the response with the `200` status
- **2026-04-07** `ff8a7389b7a4`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/mistral/apis/mistral-ai-api/docs/v1/workflows/deployments/get.md) - [API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) - [Page](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/workflows/deployments/get)
