●Change8

Migrating to Mistral Client v2.0.3

Version v2.0.3 introduces 3 breaking changes. This guide details how to update your code.

Released: 3/16/2026

3
Breaking Changes
2
Migration Steps
18
Affected Symbols

⚠️ Check Your Code

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

mistral.beta.conversations.append_streammistral.beta.conversations.startmistral.beta.conversations.appendmistral.beta.conversations.get_historymistral.beta.conversations.get_messagesmistral.beta.conversations.restartmistral.beta.conversations.start_streammistral.beta.conversations.restart_streammistral.chat.completemistral.chat.streammistral.fim.completemistral.fim.streammistral.agents.completemistral.agents.streammistral.classifiers.classify_chatmistral.classifiers.moderate_chatmistral.models.listmistral.models.retrieve

Breaking Changes

●Issue #1

The structure for `reference_ids` within request/response payloads for conversation management (`mistral.beta.conversations.*`), chat completion (`mistral.chat.complete`, `mistral.chat.stream`), FIM completion (`mistral.fim.complete`, `mistral.fim.stream`), and agent completion (`mistral.agents.*`) has changed. Specifically, paths involving `union(ThinkChunk).thinking[]` or `union(ReferenceChunk).reference_ids[]` have been modified.

●Issue #2

The structure for `reference_ids` within request/response payloads for classification (`mistral.classifiers.classify_chat`, `mistral.classifiers.moderate_chat`) has changed.

●Issue #3

The structure of the `capabilities` field in the response for `mistral.models.list()` and `mistral.models.retrieve()` has changed.

Migration Steps

  1. 1
    Review and update code interacting with the request/response schemas for `mistral.beta.conversations.append_stream`, `mistral.beta.conversations.start`, `mistral.beta.conversations.append`, `mistral.beta.conversations.get_history`, `mistral.beta.conversations.get_messages`, `mistral.beta.conversations.restart`, `mistral.beta.conversations.start_stream`, `mistral.beta.conversations.restart_stream`, `mistral.chat.complete`, `mistral.chat.stream`, `mistral.fim.complete`, `mistral.fim.stream`, `mistral.agents.complete`, and `mistral.agents.stream` to accommodate the changes in how reference IDs and thinking chunks are structured.
  2. 2
    Update code handling the response from `mistral.models.list()` and `mistral.models.retrieve()` to reflect the new structure of the `capabilities` field.

Release Summary

This release introduces breaking changes across numerous API endpoints, primarily affecting the structure of reference IDs, thinking chunks, and content representation in conversation, chat, FIM, agent, and classification operations. Model listing and retrieval responses also have schema changes.

Need More Details?

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

View Full Changelog