npm / @mistralai/mistralai
@mistralai/mistralai
What changed in @mistralai/mistralai 1 to 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-12.
189 breaking1 deprecations116 new APIs and options6 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 2147 changes
Breaking changes 89
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.
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.
@mistralai/mistralai 1115 changes
Breaking changes 87
The messages item type changed in a breaking way.
The response message type changed in a breaking way.
The messages item type changed in a breaking way.
The streamed content item type changed in a breaking way.
The segment type field changed in a breaking way.
The streamed data type changed in a breaking way.
The response object type changed in a breaking way.
The response object type changed in a breaking way.
The response object type changed in a breaking way.
The response type changed in a breaking way.
The response type changed in a breaking way.
The response type changed in a breaking way.
The conversationAppendRequest type changed in a breaking way.
The response type changed in a breaking way.
The conversationAppendStreamRequest type changed in a breaking way.
The streamed data type changed in a breaking way.
The response type changed in a breaking way.
The response type changed in a breaking way.
The inputs request type changed in a breaking way.
The response type changed in a breaking way.
The inputs request type changed in a breaking way.
The streamed data type changed in a breaking way.
The response type changed in a breaking way.
The request type changed in a breaking way.
The streamed data type changed in a breaking way.
The messages item type changed in a breaking way.
The response message type changed in a breaking way.
The messages item type changed in a breaking way.
The streamed content item type changed in a breaking way.
The request message item type changed in a breaking way.
The request input item type changed in a breaking way.
The response message type changed in a breaking way.
The streamed content item type changed in a breaking way.
The response type changed in a breaking way.
The request type changed in a breaking way.
The response type changed in a breaking way.
The response type changed in a breaking way.
The response type changed in a breaking way.
The response type changed in a breaking way.
The response object type changed in a breaking way.
The response item type changed in a breaking way.
The response type changed in a breaking way.
The response object type changed in a breaking way.
The response type changed in a breaking way.
The document request type changed in a breaking way.
The request schema changed.
The request metadata field changed.
The response content array item schema changed in a breaking change.
The request inputs array item schema changed in a breaking change.
The response entries array item schema changed in a breaking change.
The response content array item schema changed in a breaking change.
The request metadata field changed.
The response content array item schema changed in a breaking change.
The request inputs array item schema changed in a breaking change.
The response content array item schema changed in a breaking change.
The request inputs array item schema changed in a breaking change.
The response type changed in a breaking way.
The response type changed in a breaking way.
The response item type changed in a breaking way.
The response changed.
The name field in request tool execution entries changed.
The name field in tool execution entries changed in the response.
The response type changed in a breaking way.
The name field in tool execution entries changed in the response.
The response item type changed in a breaking way.
The name field in tool execution entries changed in the response.
The name field in tool execution entries changed in the response.
The request type changed in a breaking way.
The orgId field in sharingDelete changed.
The response share_with_uuid field changed.
The shareWithUuid field in response data changed.
The orgId field in sharingIn changed.
The response share_with_uuid field changed.
The response owner_id field changed.
The response owner_id field changed.
The response changed.
The response data items changed.
The response changed.
The response changed.
The response owner_id field changed.
The ownerId field in response data changed.
The response owner_id field changed.
The response total field changed.
The 422 error status was removed.
The capabilities field in model-list response data changed.
The capabilities field in the response changed.
The response pages changed.
New APIs and options 25
The list request adds an orderBy parameter.
A deleteVersionAlias API was added for beta agents.
The list request adds a search parameter.
Adds a method to get an agent version.
Adds a method to list agent versions.
Adds the request.documentAnnotationPrompt field to OCR processing.
The response now includes an outputs field.
The response now includes an outputs field.
The request now includes an inline field.
The response now includes an outputs field.
The response data items now include an outputs field.
The request now supports a metadata field.
The request now supports a metadata field.
The request now supports a metadata field.
The request adds metadata.
The request adds metadata.
A beta agent delete operation was added.
The request adds agentVersion.
A beta conversation delete operation was added.
The request adds metadata.
The request adds filtersAttributes.
The document update request adds attributes.
The request adds metadata.
The request adds includeTotal.
The request adds metadata.
Behavior and default changes 3
The request changed.
The agentUpdateRequest changed.
The request changed.