●Change8

Migrating to Mistral Client v2.1.2

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

Released: 3/20/2026

6
Breaking Changes
6
Migration Steps
16
Affected Symbols

⚠️ Check Your Code

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

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

Breaking Changes

●Issue #1

The structure of the `tools[]` field has changed in `mistral.beta.conversations.start()`, `mistral.beta.conversations.start_stream()`, `mistral.beta.agents.create()`, `mistral.beta.agents.update()`, and related list/get methods. Users must update how they define or expect tool structures in these endpoints.

●Issue #2

The structure of the `tools[]` field has changed in various `mistral.beta.agents` endpoints (`create`, `get`, `list`, `update`, `update_version`, `list_versions`, `get_version`).

●Issue #3

The structure of the `request` object has changed for `mistral.chat.complete()` and `mistral.chat.stream()`. Users must review and update their request payloads.

●Issue #4

The structure of the `response.choices[]` field has changed for `mistral.chat.complete()` and `mistral.fim.complete()`.

●Issue #5

The structure of the `request` object has changed for `mistral.agents.complete()` and `mistral.agents.stream()`. Users must review and update their request payloads.

●Issue #6

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

Migration Steps

  1. 1
    Review and update the structure of the `tools[]` field when calling `mistral.beta.conversations.start()` and `mistral.beta.conversations.start_stream()`.
  2. 2
    Review and update the structure of the `tools[]` field when interacting with `mistral.beta.agents` endpoints (create, get, list, update, etc.).
  3. 3
    Review and update the request payload structure for `mistral.chat.complete()` and `mistral.chat.stream()`.
  4. 4
    Review and update the handling of the `response.choices[]` structure for `mistral.chat.complete()` and `mistral.fim.complete()`.
  5. 5
    Review and update the request payload structure for `mistral.agents.complete()` and `mistral.agents.stream()`.
  6. 6
    Review and update the handling of the `response.choices[]` structure for `mistral.agents.complete()`.

Release Summary

This release introduces numerous breaking changes across the SDK, primarily affecting the structure of the `tools[]` field in beta conversation and agent endpoints, as well as request/response payloads for chat, FIM, and agent completion endpoints.

Need More Details?

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

View Full Changelog