●Change8

Migrating to Mistral Client v2.4.2

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

Released: 4/23/2026

2
Breaking Changes
2
Migration Steps
16
Affected Symbols

⚠️ Check Your Code

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

mistral.beta.observability.chat_completion_events.searchmistral.beta.observability.chat_completion_events.fetchmistral.beta.observability.chat_completion_events.fetch_similar_eventsmistral.beta.observability.campaigns.list_eventsmistral.workflows.execute_workflow_registrationmistral.workflows.execute_workflowmistral.chat.completemistral.beta.connectors.updatemistral.beta.connectors.getmistral.chat.streammistral.fim.completemistral.fim.streammistral.agents.completemistral.agents.streammistral.beta.connectors.listmistral.beta.connectors.create

Breaking Changes

●Issue #1

The response structure for observability methods (`search`, `fetch`, `fetch_similar_events`, `list_events`) has changed. The field `extra_fields` now uses a union type: `Map<extra_fields>.union(Map<string>)`. This may break deserialization if consumers expected a specific map type.

●Issue #2

The request parameter `request.encoded_input` has been removed from `mistral.workflows.execute_workflow_registration()` and `mistral.workflows.execute_workflow()`. Consumers must update their calls to remove this parameter.

Migration Steps

  1. 1
    Remove usage of `request.encoded_input` when calling `mistral.workflows.execute_workflow_registration()` and `mistral.workflows.execute_workflow()`.
  2. 2
    Review deserialization logic for responses from `mistral.beta.observability.chat_completion_events.search()`, `mistral.beta.observability.chat_completion_events.fetch()`, `mistral.beta.observability.chat_completion_events.fetch_similar_events()`, and `mistral.beta.observability.campaigns.list_events()` due to the change in `extra_fields` structure to a union type.

Release Summary

This release introduces prompt caching support across chat, FIM, and agent endpoints, adds title fields to connector operations, and includes breaking changes to observability response structures and workflow execution requests.

Need More Details?

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

View Full Changelog