●Change8

Migrating to Mistral Client v2.3.2

Version v2.3.2 introduces 2 breaking changes. This guide details how to update your code.

Released: 4/10/2026

2
Breaking Changes
2
Migration Steps
49
Affected Symbols

⚠️ Check Your Code

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

mistral.chat.complete()mistral.agents.complete()mistral.fim.complete()mistral.beta.observability.datasets.delete()mistral.beta.observability.campaigns.delete()mistral.beta.observability.chat_completion_events.judge()mistral.beta.observability.chat_completion_events.fields.list()mistral.beta.observability.chat_completion_events.fields.fetch_options()mistral.beta.observability.chat_completion_events.fields.fetch_option_counts()mistral.beta.observability.judges.create()mistral.beta.observability.judges.list()mistral.beta.observability.judges.fetch()mistral.beta.observability.judges.delete()mistral.beta.observability.judges.update()mistral.beta.observability.judges.judge_conversation()mistral.beta.observability.campaigns.create()mistral.beta.observability.campaigns.list()mistral.beta.observability.campaigns.fetch()mistral.beta.observability.datasets.list_records()mistral.beta.observability.campaigns.fetch_status()mistral.beta.observability.campaigns.list_events()mistral.beta.observability.datasets.create()mistral.beta.observability.datasets.list()mistral.beta.observability.datasets.fetch()mistral.beta.libraries.list()mistral.beta.observability.chat_completion_events.fetch_similar_events()mistral.beta.observability.datasets.update()mistral.beta.observability.datasets.records.update_properties()mistral.beta.observability.datasets.import_from_campaign()mistral.beta.observability.datasets.import_from_explorer()mistral.beta.observability.datasets.import_from_file()mistral.beta.observability.datasets.import_from_playground()mistral.beta.observability.datasets.import_from_dataset_records()mistral.beta.observability.datasets.export_to_jsonl()mistral.beta.observability.datasets.fetch_task()mistral.beta.observability.datasets.list_tasks()mistral.beta.observability.datasets.records.fetch()mistral.beta.observability.datasets.records.delete()mistral.beta.observability.datasets.records.bulk_delete()mistral.beta.observability.datasets.records.judge()mistral.beta.observability.datasets.records.update_payload()mistral.beta.observability.datasets.create_record()mistral.beta.observability.chat_completion_events.fetch()mistral.chat.stream()mistral.beta.observability.chat_completion_events.search_ids()mistral.fim.stream()mistral.beta.observability.chat_completion_events.search()mistral.agents.stream()mistral.workflows.deployments.get_deployment()

Breaking Changes

●Issue #1

The structure of `response.choices[].messages[]` has changed for `mistral.chat.complete()`, `mistral.agents.complete()`, and `mistral.fim.complete()`. Users must update how they access message data.

●Issue #2

The structure of streaming responses has changed for `mistral.chat.stream()`, `mistral.fim.stream()`, and `mistral.agents.stream()`. Specifically, `response.[].data.choices[].delta` structure has been modified.

Migration Steps

  1. 1
    Review and update code accessing `response.choices[].messages[]` for `mistral.chat.complete()`, `mistral.agents.complete()`, and `mistral.fim.complete()` due to structural changes.
  2. 2
    Review and update code handling streaming responses for `mistral.chat.stream()`, `mistral.fim.stream()`, and `mistral.agents.stream()` to account for changes in `response.[].data.choices[].delta`.

Release Summary

This release primarily updates error response structures across numerous observability endpoints to standardize `error.detail.error_code` and introduces breaking changes to the response formats for chat, agent, and FIM completion methods, including streaming.

Need More Details?

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

View Full Changelog