●Change8

Migrating to Mistral Client v1.12.3

Version v1.12.3 introduces 13 breaking changes. This guide details how to update your code.

Released: 2/17/2026

13
Breaking Changes
5
Migration Steps
20
Affected Symbols

⚠️ Check Your Code

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

mistral.fine-tuning.jobs.createmistral.models.updatemistral.models.archivemistral.models.unarchivemistral.batch.jobs.cancelmistral.batch.jobs.getmistral.batch.jobs.createmistral.batch.jobs.listmistral.fine-tuning.jobs.startmistral.fine-tuning.jobs.cancelmistral.fine-tuning.jobs.getmistral.fine-tuning.jobs.listmistral.beta.agents.listmistral.beta.agents.get_versionmistral.beta.agents.list_versionsmistral.beta.agents.update_versionmistral.beta.agents.updatemistral.beta.agents.getmistral.beta.agents.delete_version_aliasmistral.beta.agents.create

Breaking Changes

●Issue #1

The structure of the `request` for `mistral.fine-tuning.jobs.create()` has changed.

●Issue #2

The structure of the `response` for `mistral.fine-tuning.jobs.create()` has changed.

●Issue #3

The structure of the `response` for `mistral.models.update()` has changed.

●Issue #4

The structure of `response.object` for `mistral.models.archive()` has changed.

●Issue #5

The structure of `response.object` for `mistral.models.unarchive()` has changed.

●Issue #6

The structure of `response.object` for `mistral.batch.jobs.cancel()` has changed.

●Issue #7

The structure of `response.object` for `mistral.batch.jobs.get()` has changed.

●Issue #8

The structure of `response.object` for `mistral.batch.jobs.create()` has changed.

●Issue #9

The structure of the `response` for `mistral.batch.jobs.list()` has changed.

●Issue #10

The structure of the `response` for `mistral.fine-tuning.jobs.start()` has changed.

●Issue #11

The structure of the `response` for `mistral.fine-tuning.jobs.cancel()` has changed.

●Issue #12

The structure of the `response` for `mistral.fine-tuning.jobs.get()` has changed.

●Issue #13

The structure of the `response` for `mistral.fine-tuning.jobs.list()` has changed.

Migration Steps

  1. 1
    Review changes to the request and response schemas for `mistral.fine-tuning.jobs.create()`.
  2. 2
    Review changes to the response schema for `mistral.models.update()`.
  3. 3
    Review changes to the `response.object` schema for `mistral.models.archive()` and `mistral.models.unarchive()`.
  4. 4
    Review changes to the `response.object` schema for batch job operations (`cancel`, `get`, `create`, `list`).
  5. 5
    Review changes to the response schema for fine-tuning job operations (`start`, `cancel`, `get`, `list`).

Release Summary

This release introduces numerous breaking changes to request and response schemas across fine-tuning, model management, batch jobs, and beta agent endpoints. It also adds several new fields related to version messages and search/ordering capabilities in beta agent and batch job endpoints.

Need More Details?

View the full release notes and all changes for Mistral Client v1.12.3.

View Full Changelog