---
title: "Changes to Get Workflow Registrations"
method: GET
path: "/v1/workflows/registrations"
---

# Changes to Get Workflow Registrations

`GET /v1/workflows/registrations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 14 revisions.

- **2026-10-12** `6c349f3bdef6`: 1 info
- **2026-07-13** `5a5c361558bb`: 5 breaking, 2 warning, 15 info
- **2026-04-07** `ff8a7389b7a4`: 1 info

## Changes

- **2026-10-12** `6c349f3bdef6`: 1 info
  - added the new optional `query` request parameter `workflow_name`
- **2026-07-13** `5a5c361558bb`: 5 breaking, 2 warning, 15 info
  - the response property `workflow_registrations/items/task_queue` became optional for the status `200`
  - the response property `workflow_versions/items/task_queue` became optional for the status `200`
  - response property `workflow_registrations/items/task_queue` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `workflow_versions/items/task_queue` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `next_cursor/anyOf[subschema #1]/` response's property format changed from `uuid` to no format for status `200`
  - for the `query` request parameter `limit`, the max was set to `1000.00`
  - for the `query` request parameter `limit`, the min was set to `1.00`
  - api tag `workflows` added
  - api tag `beta.workflows` removed
  - for the `query` request parameter `cursor`, the format of property `anyOf[subschema #1]/` was generalized from `uuid` to no format
  - added the optional property `workflow_registrations/items/definition/on_behalf_of` to the response with the `200` status
  - added the optional property `workflow_registrations/items/definition/plugin_metadata` to the response with the `200` status
  - added the optional property `workflow_registrations/items/deployment_id` to the response with the `200` status
  - added the optional property `workflow_registrations/items/deployment_name` to the response with the `200` status
  - added the optional property `workflow_registrations/items/workflow/anyOf[subschema #1: Workflow]/tags` to the response with the `200` status
  - added the optional property `workflow_versions/items/definition/on_behalf_of` to the response with the `200` status
  - added the optional property `workflow_versions/items/definition/plugin_metadata` to the response with the `200` status
  - added the optional property `workflow_versions/items/deployment_id` to the response with the `200` status
  - added the optional property `workflow_versions/items/deployment_name` to the response with the `200` status
  - added the optional property `workflow_versions/items/workflow/anyOf[subschema #1: Workflow]/tags` to the response with the `200` status
  - response property `workflow_registrations/items/task_queue` deprecated
  - response property `workflow_versions/items/task_queue` deprecated
- **2026-04-07** `ff8a7389b7a4`: 1 info
  - endpoint added

---

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