●Change8

Migrating to Mistral Client v2.3.1

Version v2.3.1 introduces 6 breaking changes. This guide details how to update your code.

Released: 4/7/2026

6
Breaking Changes
6
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

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

mistral.ocr.processmistral.chat.completemistral.fim.completemistral.agents.completemistral.workflows.executions.stream

Breaking Changes

●Issue #1

The `request` parameter for `mistral.ocr.process()` has changed. Review the new signature.

●Issue #2

The structure of `response.pages[]` in the output of `mistral.ocr.process()` has changed.

●Issue #3

The structure of `response.choices[]` in the output of `mistral.chat.complete()` has changed.

●Issue #4

The structure of `response.choices[]` in the output of `mistral.fim.complete()` has changed.

●Issue #5

The structure of `response.choices[]` in the output of `mistral.agents.complete()` has changed.

●Issue #6

The `event_source` parameter within the `request` for `mistral.workflows.executions.stream()` has changed.

Migration Steps

  1. 1
    Update usage of `mistral.ocr.process()` to reflect the new `request` parameter structure.
  2. 2
    Update code that processes `response.pages[]` from `mistral.ocr.process()` to handle the new structure.
  3. 3
    Update code that processes `response.choices[]` from `mistral.chat.complete()` to handle the new structure.
  4. 4
    Update code that processes `response.choices[]` from `mistral.fim.complete()` to handle the new structure.
  5. 5
    Update code that processes `response.choices[]` from `mistral.agents.complete()` to handle the new structure.
  6. 6
    Update usage of `mistral.workflows.executions.stream()` to reflect the change in `request.event_source`.

Release Summary

This release introduces several breaking changes across various SDK methods, primarily affecting the structure of request parameters and response objects for OCR, chat, FIM, agents, and workflow execution streaming.

Need More Details?

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

View Full Changelog