●Change8

Migrating to Mistral Client v2.2.0rc1

Version v2.2.0rc1 introduces 4 breaking changes. This guide details how to update your code.

Released: 3/30/2026

4
Breaking Changes
7
Migration Steps
48
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

mistral.models.listmistral.beta.connectors.list_toolsmistral.models.updatemistral.models.retrievemistral.workflows.metrics.get_workflow_metricsmistral.workflows.get_workflowmistral.workflows.update_workflowmistral.workflows.get_workflow_registrationmistral.workflows.archive_workflowmistral.workflows.unarchive_workflowmistral.workflows.executions.get_workflow_executionmistral.workflows.executions.get_workflow_execution_historymistral.workflows.executions.signal_workflow_executionmistral.workflows.executions.query_workflow_executionmistral.workflows.executions.terminate_workflow_executionmistral.workflows.executions.batch_terminate_workflow_executionsmistral.workflows.executions.cancel_workflow_executionmistral.workflows.executions.batch_cancel_workflow_executionsmistral.workflows.executions.reset_workflowmistral.workflows.executions.update_workflow_executionmistral.workflows.executions.get_workflow_execution_trace_otelmistral.workflows.executions.get_workflow_execution_trace_summarymistral.workflows.executions.get_workflow_execution_trace_eventsmistral.workflows.executions.streammistral.workflows.runs.get_runmistral.batch.jobs.deletemistral.workflows.runs.list_runsmistral.workflows.runs.get_run_historymistral.workflows.schedules.get_schedulesmistral.workflows.schedules.schedule_workflowmistral.workflows.schedules.unschedule_workflowmistral.workflows.events.receive_workflow_eventmistral.workflows.events.receive_workflow_events_batchmistral.workflows.events.get_stream_eventsmistral.workflows.events.get_workflow_eventsmistral.workflows.deployments.list_deploymentsmistral.workflows.deployments.get_deploymentmistral.events.receive_workflow_eventmistral.events.receive_workflow_events_batchmistral.events.get_stream_eventsmistral.events.get_workflow_eventsmistral.audio.voices.listmistral.workflows.execute_workflow_registrationmistral.workflows.execute_workflowmistral.workflows.get_workflow_registrationsmistral.beta.libraries.listmistral.beta.connectors.call_toolmistral.workflows.get_workflows

Breaking Changes

●Issue #1

The response structure for `mistral.models.list()` has changed, specifically concerning `response.data[].union(fine-tuned).job`.

●Issue #2

The response structure for `mistral.beta.connectors.list_tools()` has changed.

●Issue #3

The response structure for `mistral.models.update()` has changed.

●Issue #4

The response structure for `mistral.models.retrieve()` has changed, specifically concerning `response.union(fine-tuned).job`.

Migration Steps

  1. 1
    Review and update code referencing the response structure of `mistral.models.list()` due to changes in `response.data[].union(fine-tuned).job`.
  2. 2
    Review and update code referencing the response structure of `mistral.beta.connectors.list_tools()`.
  3. 3
    Review and update code referencing the response structure of `mistral.models.update()`.
  4. 4
    Review and update code referencing the response structure of `mistral.models.retrieve()` due to changes in `response.union(fine-tuned).job`.
  5. 5
    Review the request structure for `mistral.beta.libraries.list()`.
  6. 6
    Handle potential 422 status errors in the response from `mistral.beta.libraries.list()`.
  7. 7
    Update calls to `mistral.beta.connectors.call_tool()` to optionally include `request.credentials_name`.

Release Summary

This release introduces extensive new functionality for Workflows, including execution, scheduling, runs, and event handling, alongside several breaking changes to existing model and connector response structures.

Need More Details?

View the full release notes and all changes for Mistral Client v2.2.0rc1.

View Full Changelog