v2.0.3

Breaking Changes

📅 Mar 16, 2026📦 mistral-clientView on GitHub →

⚠ 3 breaking🔧 18 symbols

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.

⚠️ Breaking Changes

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.
The structure for `reference_ids` within request/response payloads for classification (`mistral.classifiers.classify_chat`, `mistral.classifiers.moderate_chat`) has changed.
The structure of the `capabilities` field in the response for `mistral.models.list()` and `mistral.models.retrieve()` has changed.

Migration Steps

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.
Update code handling the response from `mistral.models.list()` and `mistral.models.retrieve()` to reflect the new structure of the `capabilities` field.

Affected Symbols