●Change8

Migrating to Mistral Client v1.10.0

Version v1.10.0 introduces 25 breaking changes. This guide details how to update your code.

Released: 12/17/2025

25
Breaking Changes
10
Migration Steps
32
Affected Symbols

⚠️ Check Your Code

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

mistral.beta.libraries.createmistral.beta.libraries.documents.getmistral.models.listmistral.files.listmistral.beta.conversations.startmistral.beta.libraries.accesses.deletemistral.beta.libraries.accesses.update_or_createmistral.beta.conversations.appendmistral.beta.libraries.accesses.listmistral.beta.conversations.restartmistral.beta.libraries.documents.updatemistral.beta.libraries.documents.uploadmistral.beta.libraries.documents.listmistral.beta.libraries.updatemistral.beta.libraries.deletemistral.beta.libraries.getmistral.beta.conversations.get_historymistral.beta.libraries.listmistral.models.retrievemistral.agents.completemistral.beta.agents.getmistral.beta.agents.listmistral.beta.agents.update_versionmistral.beta.agents.deletemistral.beta.conversations.listmistral.beta.conversations.getmistral.beta.agents.updatemistral.beta.conversations.deletemistral.chat.completemistral.fim.completemistral.beta.agents.createmistral.ocr.process

Breaking Changes

●Issue #1

`mistral.beta.libraries.create()`: The structure of `response.owner_id` has changed.

●Issue #2

`mistral.beta.libraries.documents.get()`: The structure of the `response` object has changed.

●Issue #3

`mistral.models.list()`: The error structure for status 422 has been removed.

●Issue #4

`mistral.files.list()`: The structure of `response.total` has changed.

●Issue #5

`mistral.beta.conversations.start()`: The structure of the `request` object has changed, and the structure of `response.outputs.[].[tool_execution_entry].name` has changed.

●Issue #6

`mistral.beta.libraries.accesses.update_or_create()`: The structure of `response.share_with_uuid` has changed.

●Issue #7

`mistral.beta.conversations.append()`: The structure of `request.inputs.[array].[].[tool_execution_entry].name` has changed, and the structure of `response.outputs.[].[tool_execution_entry].name` has changed.

●Issue #8

`mistral.beta.libraries.accesses.list()`: The structure of `response.data.[].share_with_uuid` has changed.

●Issue #9

`mistral.beta.conversations.restart()`: The structure of the `request` object has changed, and the structure of `response.outputs.[].[tool_execution_entry].name` has changed.

●Issue #10

`mistral.beta.libraries.documents.update()`: The structure of the `response` object has changed.

●Issue #11

`mistral.beta.libraries.documents.upload()`: The structure of the `response` object has changed.

●Issue #12

`mistral.beta.libraries.documents.list()`: The structure of `response.data.[]` has changed.

●Issue #13

`mistral.beta.libraries.update()`: The structure of `response.owner_id` has changed.

●Issue #14

`mistral.beta.libraries.delete()`: The structure of `response.owner_id` has changed.

●Issue #15

`mistral.beta.libraries.get()`: The structure of `response.owner_id` has changed.

●Issue #16

`mistral.beta.conversations.get_history()`: The structure of `response.entries.[].[tool_execution_entry].name` has changed.

●Issue #17

`mistral.beta.libraries.list()`: The structure of `response.data.[].owner_id` has changed.

●Issue #18

`mistral.beta.agents.get()`: The structure of the `response` object has changed.

●Issue #19

`mistral.beta.agents.list()`: The structure of the `request` and `response.[]` objects have changed.

●Issue #20

`mistral.beta.agents.update_version()`: The structure of the `response` object has changed.

●Issue #21

`mistral.beta.conversations.list()`: The structure of `response.[]` has changed.

●Issue #22

`mistral.beta.conversations.get()`: The structure of the `response` object has changed.

●Issue #23

`mistral.beta.agents.update()`: The structure of the `request` and `response` objects have changed.

●Issue #24

`mistral.beta.agents.create()`: The structure of the `response` object has changed.

●Issue #25

`mistral.ocr.process()`: The structure of the `request` and `response.pages.[]` objects have changed.

Migration Steps

  1. 1
    Review changes to `response.owner_id` in `mistral.beta.libraries.create()`, `mistral.beta.libraries.update()`, `mistral.beta.libraries.delete()`, `mistral.beta.libraries.get()`, and `mistral.beta.libraries.list()`.
  2. 2
    Update handling for `response` in `mistral.beta.libraries.documents.get()`, `mistral.beta.libraries.documents.update()`, and `mistral.beta.libraries.documents.upload()`.
  3. 3
    Remove handling for status 422 errors from `mistral.models.list()` responses.
  4. 4
    Update logic for `response.total` in `mistral.files.list()`.
  5. 5
    Review changes to request and response structures for conversation endpoints: `mistral.beta.conversations.start()`, `mistral.beta.conversations.append()`, `mistral.beta.conversations.restart()`, `mistral.beta.conversations.get_history()`, `mistral.beta.conversations.list()`, and `mistral.beta.conversations.get()`.
  6. 6
    Review changes to `response.share_with_uuid` in `mistral.beta.libraries.accesses.delete()`, `mistral.beta.libraries.accesses.update_or_create()`, and `mistral.beta.libraries.accesses.list()`.
  7. 7
    Review changes to `response.data.[]` in `mistral.beta.libraries.documents.list()`.
  8. 8
    Review changes to model capabilities in `mistral.models.list()` and `mistral.models.retrieve()`.
  9. 9
    Update agent related calls (`mistral.beta.agents.get()`, `mistral.beta.agents.list()`, `mistral.beta.agents.update_version()`, `mistral.beta.agents.update()`, `mistral.beta.agents.create()`) to accommodate request/response structure changes.
  10. 10
    Update OCR processing calls (`mistral.ocr.process()`) to reflect request/response changes.

Release Summary

Mistral AI SDK v1.10.0 introduces several new features like metadata support and agent deletion, but mandates significant updates due to numerous breaking changes in API response structures and request parameters across various endpoints.

Need More Details?

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

View Full Changelog