npm / @mistralai/mistralai
@mistralai/mistralai
What changed in @mistralai/mistralai 2 to 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-12.
103 breaking1 deprecations91 new APIs and options3 behavior and defaults2 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@mistralai/mistralai 352 changes
Breaking changes 13
The gender field type changed from string to VoiceGender.
The request no longer accepts the slug field.
The gender field type changed from string to VoiceGender.
The beta managedIndexes operations and related beta surface were removed.
The spec request field changed; the notes do not specify the new shape.
Added serviceAccountId to beta observability logs, traces, and spans responses; it is also now required on the listed observability models.
The existing stable SystemV2 model now requires kind.
Removed the organization-credentials deletion API.
Removed the user-credentials deletion API.
Removed the workspace-credentials deletion API.
Removed from the stable API surface.
The code field is now required on the stable SecurityError model.
The runs property now uses WorkflowsRuns instead of Runs.
Deprecations 1
Deprecated the connector tool-calling API.
New APIs and options 37
Connector list, create, get, and update responses now include openapiSpec.
The response now includes kind and spec fields.
Added the stable addWorkflowTags operation.
Deployment responses now include requestedRoles.
Added the stable getDeploymentArchive operation.
Added an API for searching voices.
Added an API for deleting connector credentials.
Added an API for importing dataset records from spans.
Added an API for creating an evaluation pipeline.
Added an API for deleting an evaluation pipeline.
Added an evaluation retrieval API.
Added an API for retrieving an evaluation pipeline.
Added an evaluation listing API.
Added an API for listing evaluation pipelines.
Added an API for retrieving an evaluation optimization.
Added an API for listing evaluation optimizations.
Added an API for listing optimization trials.
Added an API for retrieving an evaluation project.
Added an API for listing evaluation projects.
Added an API for retrieving an evaluation record.
Added an API for searching evaluation records.
Added an API for computing evaluation-run statistics.
Added an API for retrieving an evaluation run.
Added an API for retrieving evaluation-run statistics.
Added an API for searching evaluation runs.
Added an API for searching all evaluation runs.
Added an API for updating an evaluation pipeline.
Added an API for aggregating span evaluations.
Added an API for retrieving a managed-index chunk.
Added the managed-index grep API.
Added the managed-index navigation API.
Added the managed-index read API.
The create request now accepts roleIds.
The request now accepts logType.
The request now accepts owner.
Added an API for unharden deployment.
The request now accepts workflowName.
Behavior and default changes 1
The githubUrl request field changed; the generated type now allows string, null, or undefined.
@mistralai/mistralai 2148 changes
Breaking changes 90
Added this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Added this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Removed this API operation.
Is now a union of HTTPConnector and MCPConnector, discriminated on protocol; fields that were flat now live on the variant.
Now takes a single request object; named arguments are no longer accepted.
Now takes a request_body; named arguments are no longer accepted.
Three fields are now required.
Required on the create payload in TypeScript; it no longer defaults to "mcp". Python still defaults it.
The service_tier field has been removed.
The errorCode schema changed across observability operations, affecting error handling.
The request schema changed, so callers may need to update the request they send.
The choices response schema changed, which may require updates to response handling.
The metadata request schema changed and may require changes to speech completion requests.
Agent metadata schemas changed across create, get, list, and version operations.
Connector create, get, update, and list responses no longer include tools.
The conversations list response schema changed.
The start request schema changed and may require updates to conversation creation calls.
The start stream request schema changed.
The request schema changed, so callers may need to update the request they send.
The choices response schema changed, which may require updates to response handling.
The request schema changed, so callers may need to update the request they send.
The error.detail.errorCode field changed across beta observability APIs, which may affect code handling their error responses.
The request and response.choices[] shapes changed; the notes mark both as breaking changes.
The request and streamed tool-call type changed; the notes mark both as breaking changes.
The response shape changed; the notes mark this as a breaking change.
The request and response.choices[] shapes changed; the notes mark both as breaking changes.
The request and streamed tool-call type changed; the notes mark both as breaking changes.
The toolCalls[].type request field changed; the notes mark this as a breaking change.
The toolCalls[].type request field changed; the notes mark this as a breaking change.
The choices response schema changed, which may require updates to response handling.
The streamed tool-call type changed; the notes mark this as a breaking change.
The response shape changed; the notes mark this as a breaking change.
The request shape changed as a breaking change, and response.pages[] also changed.
The request.tools[] field changed in a breaking change.
The response.tools[] field changed in a breaking change.
The response.tools[] field changed in a breaking change.
The response tools[] field changed in a breaking change.
The response tools[] field changed in a breaking change.
The request tools[] field changed in a breaking change.
The response.tools[] field changed in a breaking change.
The response tools[] field changed in a breaking change.
The response tools[] field changed in a breaking change.
The request.tools[] field changed in a breaking change.
The request.tools[] field changed in a breaking change.
The request changed in a breaking change.
The request changed in a breaking change.
The request type changed, which may require updates to code using this API.
The response type changed, which may require updates to code using this API.
The response type changed, which may require updates to code using this API.
The response type changed, which may require updates to code using this API.
The response item type changed, which may require updates to code using this API.
The response item type changed, which may require updates to code using this API.
The updateAgentRequest type changed, which may require updates to code using this API.
The response type changed, which may require updates to code using this API.
The response type changed, which may require updates to code using this API.
The conversation retrieval response schema changed.
The response item type changed, which may require updates to code using this API.
The conversation restart request schema changed.
The conversation restart stream request schema changed.
The request type changed, which may require updates to code using this API.
The request type changed, which may require updates to code using this API.
The request changed in a breaking change.
The request changed in a breaking change.
Entity types use the entity name without a request or response suffix; this is an example of the 42 type renames.
Entity types use the entity name without a request or response suffix; this is an example of the 42 type renames.
Request body types follow the {Verb}{Entity}Request naming convention; this is an example of the 42 type renames.
The SDK ships as ESM only; CommonJS require() is no longer supported.
Response types follow the {Verb}{Entity}Response naming convention; this is an example of the 42 type renames.
The GCP SDK class is renamed to MistralGCP.
The GCP SDK error class is renamed to MistralGCPError.
Ambiguous type names are automatically resolved during generation; for example, Tools becomes ConversationRequestTool.
Runtime validation is upgraded from Zod v3 to Zod v4; directly imported SDK schemas are now Zod v4 schemas.
New APIs and options 54
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added this API operation.
Added an API to create or update organization credentials.
Added an API to create or update user credentials.
Added an API to create or update workspace credentials.
Added an API to delete organization credentials.
Added an API to delete user credentials.
Added an API to delete workspace credentials.
Added an API to retrieve authentication methods.
The authentication URL request now accepts credentialsName.
Added an API to list organization credentials.
The list tools request now accepts credentialsName.
Added an API to list user credentials.
Added an API to list workspace credentials.
Library creation requests now accept ownerType.
Added an API to list ingestion pipeline configurations.
Deployment list entries now include location.
Workflow execution requests now accept extensions, and the response includes runId.
Workflow registration execution requests now accept extensions, and the response includes runId.
Workflow responses now include onBehalfOf.
Run listing requests now accept userId, and listed executions include runId.
Think chunks can now include a signature in conversation inputs, outputs, and streams, and in classifier inputs.
Added the type field to the request for listing audio voices.
Added an API to delete batch jobs.
Added credentialsName to the callTool request.
Added request and pagination response fields, and support for a 422 error response.
Added APIs to retrieve stream events and workflow events.
Added workflow APIs for managing workflows and registrations, executions, runs, schedules, events, metrics, and deployments.
Added the connectors listTools API to the Mistral beta client.
Added the audio speech completion API.
Added the audio voice creation API.
Added the audio voice deletion API.
Added the audio voice retrieval API.
Added the audio voice sample retrieval API.
Added the audio voices list API.
Added the audio voice update API.
Added reasoningEffort to completionArgs in the conversation append request.
Added reasoningEffort to completionArgs in the conversation append stream request.
Added the reasoning capability field to model items in the list response.
Added the reasoning capability field to the retrieved model response.
Discriminated unions gain an Unknown variant so older SDK versions can handle new API values.
Behavior and default changes 2
authorization_endpoint is now optional.
Enums accept unknown values, so new API values will not crash older SDK versions.
Fixes and other changes 2
The end field is now nullable because the API can return null for diarized transcriptions.
The start field is now nullable because the API can return null for diarized transcriptions.