●Change8

Migrating to Mistral Client v2.0.1

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

Released: 3/12/2026

4
Breaking Changes
6
Migration Steps
21
Affected Symbols

⚠️ Check Your Code

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

mistral.chat.complete()mistral.classifiers.classify_chat()mistral.classifiers.moderate_chat()mistral.agents.stream()mistral.agents.complete()mistral.fim.stream()mistral.fim.complete()mistral.chat.stream()mistral.beta.conversations.restart_stream()mistral.beta.agents.update()mistral.beta.agents.update_version()mistral.beta.agents.list_versions()mistral.beta.agents.get_version()mistral.beta.agents.get()mistral.beta.agents.list()mistral.beta.agents.create()mistral.beta.conversations.start()mistral.beta.conversations.start_stream()mistral.beta.conversations.restart()mistral.beta.conversations.get()mistral.beta.conversations.list()

Breaking Changes

●Issue #1

The union containing `user.content.union(Array<ContentChunk>)[].union(audio_url)` has been removed from the `content` field in requests and responses for `mistral.chat.complete()`, `mistral.agents.stream()`, `mistral.agents.complete()`, `mistral.chat.stream()`, and `mistral.fim.complete()`.

●Issue #2

The union containing `user.content.union(Array<ContentChunk>)[].union(audio_url)` has been removed from the `content` field in requests for `mistral.classifiers.classify_chat()`.

●Issue #3

The union containing `user.content.union(Array<ContentChunk>)[].union(audio_url)` has been removed from the `content` field in requests for `mistral.classifiers.moderate_chat()`.

●Issue #4

The union containing `response.[].data.choices[].delta.content.union(Array<ContentChunk>)[].union(audio_url)` has been removed from streaming responses for `mistral.agents.stream()`, `mistral.chat.stream()`, and `mistral.fim.stream()`.

Migration Steps

  1. 1
    Review usages of `mistral.chat.complete()`, `mistral.classifiers.classify_chat()`, `mistral.classifiers.moderate_chat()`, `mistral.agents.stream()`, `mistral.agents.complete()`, `mistral.fim.stream()`, `mistral.fim.complete()`, and `mistral.chat.stream()` to remove references to the removed union structure involving `audio_url` and `Array<ContentChunk>` within message content.
  2. 2
    Update requests for `mistral.beta.conversations.restart_stream()` and `mistral.beta.conversations.restart()` to reflect the change in the structure of `request.guardrails[]`.
  3. 3
    Update requests and responses for `mistral.beta.agents.update()`, `mistral.beta.agents.update_version()`, `mistral.beta.agents.get_version()`, `mistral.beta.agents.get()`, and `mistral.beta.agents.create()` based on the changed request/response schemas.
  4. 4
    Update requests for `mistral.beta.conversations.start()` and `mistral.beta.conversations.start_stream()` to reflect the changed request schema.
  5. 5
    Update responses for `mistral.beta.agents.list_versions()` and `mistral.beta.agents.list()` based on the changed response structure (`response.[]`).
  6. 6
    Update responses for `mistral.beta.conversations.get()` and `mistral.beta.conversations.list()` based on the changed response structure (`response.union(ModelConversation)` or `response.[].union(ModelConversation)`).

Release Summary

This release introduces several breaking changes by removing support for specific union structures involving audio URLs and content chunks in request and response payloads across chat, classification, agent, and FIM endpoints. Additionally, several beta endpoints have schema updates.

Need More Details?

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

View Full Changelog