> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mistral AI

> Mistral AI is a research lab building state-of-the-art open-source language models and providing APIs for developers and enterprises to integrate these models into their applications.

![Mistral AI logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/mistral_ai.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=f674d0d6bba624802e9c2a9c7e180a40)

* **Category:** artificial intelligence
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 105
* **Triggers:** 0
* **Slug:** `MISTRAL_AI`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Append to conversation
>
> **Slug:** `MISTRAL_AI_APPEND_TO_CONVERSATION`
>
> Tool to append new entries to an existing conversation in Mistral AI. Use when you need to continue a conversation by adding new messages or inputs. This is a beta endpoint.
>
> #### Input Parameters
>
> **store** `boolean`
>
> Whether to persist the conversation results to the server. Defaults to true
>
> **inputs** `string` *required*
>
> New input to append to the conversation. Can be a string (simple text input) or an array of entry objects (MessageInputEntry, MessageOutputEntry, FunctionResultEntry, etc.)
>
> **completion\_args** `object`
>
> White-listed arguments from the completion API to configure the response generation (e.g., temperature, max\_tokens)
>
> **conversation\_id** `string` *required*
>
> ID of the conversation to which entries will be appended
>
> **handoff\_execution** `string ("client" | "server")`
>
> Handoff execution mode for agent handoffs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Archive Fine-Tuned Model
>
> **Slug:** `MISTRAL_AI_ARCHIVE_FINE_TUNED_MODEL`
>
> Archive a fine-tuned model so it is unavailable until restored.
>
> #### Input Parameters
>
> **model\_id** `string` *required*
>
> Fine-tuned model identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Count Chat Completion Field Options
>
> **Slug:** `MISTRAL_AI_COUNT_CHAT_COMPLETION_FIELD_OPTIONS`
>
> Count values of a chat completion field after optional filtering.
>
> #### Input Parameters
>
> **field\_name** `string` *required*
>
> Chat completion field whose values to count. Call List Chat Completion Fields first to discover valid field names.
>
> **filter\_params** `object`
>
> Optional filter object with required `filters`. Use a condition with `field`, `op`, and `value`, or nest conditions in `AND`/`OR` arrays. Example: `{"filters":{"field":"model","op":"eq","value":"mistral-large"}}`. Operators: lt, lte, gt, gte, startswith, istartswith, endswith, iendswith, contains, icontains, matches, notcontains, inotcontains, eq, neq, isnull, includes, excludes, len\_eq.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Agent
>
> **Slug:** `MISTRAL_AI_CREATE_AGENT`
>
> Tool to create a new AI agent with custom configuration (Beta). Use when you need to create an agent with specific model, name, instructions, and tools.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the agent
>
> **model** `string` *required*
>
> Model ID to use for the agent (e.g., 'mistral-large-latest', 'mistral-small-latest')
>
> **tools** `array`
>
> List of tools available to the agent. Can include function tools, web search, code interpreter, image generation, or document library tools
>
> **handoffs** `array`
>
> Optional handoff configuration for agent-to-agent transfers
>
> **metadata** `object`
>
> Optional metadata to attach to the agent
>
> **description** `string`
>
> Optional description of the agent's purpose and capabilities
>
> **instructions** `string`
>
> System instructions that guide the agent's behavior during conversations
>
> **completion\_args** `object`
>
> White-listed arguments from the completion API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Agents Completion
>
> **Slug:** `MISTRAL_AI_CREATE_AGENTS_COMPLETION`
>
> Tool to generate completions using a Mistral AI agent with specific instructions and tools. Use when you need an agent to process messages and generate responses. Agents can use tools, follow instructions, and maintain conversation context.
>
> #### Input Parameters
>
> **n** `integer`
>
> Number of completions to generate. Input tokens are billed once
>
> **stop** `string`
>
> Stop generation when this token (or any of these tokens if array) is detected
>
> **tools** `array`
>
> List of tools available for the agent to use during completion
>
> **top\_p** `number`
>
> Nucleus sampling parameter (0.0-1.0). Consider only tokens with cumulative probability >= top\_p
>
> **stream** `boolean`
>
> Whether to stream partial responses. If true, returns server-sent events. Default false
>
> **agent\_id** `string` *required*
>
> ID of the agent to use for this completion. Obtain from listing or creating agents
>
> **messages** `array` *required*
>
> List of messages forming the conversation. Must contain at least one message. Each message has a role ('system', 'user', 'assistant', 'tool') and content
>
> **metadata** `object`
>
> Additional metadata to attach to the completion request
>
> **max\_tokens** `integer`
>
> Maximum number of tokens to generate. The total of prompt + max\_tokens cannot exceed model's context length
>
> **prediction** `object`
>
> Prediction configuration for optimizing response times.
>
> **prompt\_mode** `string`
>
> Prompt mode: 'reasoning' to enable reasoning mode with system prompt for reasoning models
>
> **random\_seed** `integer`
>
> Random seed for deterministic sampling. Same seed with same inputs produces same outputs
>
> **temperature** `number`
>
> Sampling temperature (0.0-2.0). Higher values make output more random, lower values more deterministic
>
> **tool\_choice** `string`
>
> Controls tool selection: 'auto' (default), 'any', 'none', or specific tool object
>
> **response\_format** `object`
>
> Response format configuration.
>
> **presence\_penalty** `number`
>
> Penalty for token presence (-2.0 to 2.0). Positive values encourage diverse vocabulary
>
> **frequency\_penalty** `number`
>
> Penalty for token frequency (-2.0 to 2.0). Positive values discourage repetition based on frequency
>
> **parallel\_tool\_calls** `boolean`
>
> Whether to allow parallel tool calls. Default true
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Audio Transcription
>
> **Slug:** `MISTRAL_AI_CREATE_AUDIO_TRANSCRIPTION`
>
> Transcribe audio files to text using Mistral AI's Voxtral models. Use this action to convert speech in audio files to written text. Supports multiple input methods: file upload, file\_id from previously uploaded files, or file\_url for publicly accessible audio. The transcription supports 13 languages with automatic language detection, speaker diarization, and configurable timestamp granularities (segment or word level). Key features: - Multi-language support (English, Chinese, Hindi, Spanish, Arabic, French, Portuguese, Russian, German, Japanese, Korean, Italian, Dutch) - Speaker diarization to identify different speakers - Word and segment-level timestamps - Context biasing for domain-specific terminology - Supports common audio formats (mp3, wav, m4a, etc.) Note: Exactly one of file, file\_id, or file\_url must be provided. The action does not support streaming mode.
>
> #### Input Parameters
>
> **file** `object`
>
> Audio file to transcribe. Supported formats include common audio formats (mp3, wav, m4a, etc.). Mutually exclusive with file\_id and file\_url - provide only one of these three options.
>
> **model** `string` *required*
>
> ID of the model to use for transcription. Use 'voxtral-mini-latest' for the latest version or 'voxtral-mini-2602' for a specific version. Supports 13 languages: English, Chinese, Hindi, Spanish, Arabic, French, Portuguese, Russian, German, Japanese, Korean, Italian, and Dutch.
>
> **diarize** `boolean`
>
> Enable speaker diarization to identify different speakers in the audio. When enabled, the response will include speaker labels with timestamps.
>
> **file\_id** `string`
>
> ID of a previously uploaded file to transcribe. Obtain this from MISTRAL\_AI\_UPLOAD\_FILE or MISTRAL\_AI\_LIST\_FILES actions. Mutually exclusive with file and file\_url - provide only one of these three options.
>
> **file\_url** `string`
>
> URL of an audio file to transcribe. The file must be publicly accessible. Mutually exclusive with file and file\_id - provide only one of these three options.
>
> **language** `string`
>
> Language code of the audio (e.g., 'en' for English, 'fr' for French, 'es' for Spanish, 'zh' for Chinese). Providing the language can improve transcription accuracy. If not provided, the language will be auto-detected.
>
> **temperature** `number`
>
> Sampling temperature between 0 and 1. Higher values (e.g., 0.8) make output more random, lower values (e.g., 0.2) make it more focused and deterministic.
>
> **context\_bias** `array`
>
> List of words or phrases to bias the transcription towards. Each item should be a single word or phrase without commas or whitespace within it. Use this to improve accuracy for domain-specific terminology.
>
> **timestamp\_granularities** `array`
>
> Granularities of timestamps to include in the response. Options: 'segment' for segment-level timestamps, 'word' for word-level timestamps. Can include both for detailed timing information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Batch Job
>
> **Slug:** `MISTRAL_AI_CREATE_BATCH_JOB`
>
> Create and queue a Mistral batch inference job.
>
> #### Input Parameters
>
> **model** `string`
>
> Model used for batch inference.
>
> **agent\_id** `string`
>
> Deprecated agent identifier.
>
> **endpoint** `string ("/v1/chat/completions" | "/v1/embeddings" | "/v1/fim/completions" | "/v1/moderations" | "/v1/chat/moderations" | "/v1/ocr" | "/v1/classifications" | "/v1/chat/classifications" | "/v1/conversations" | "/v1/audio/transcriptions")` *required*
>
> API endpoint used for batch inference.
>
> **metadata** `object`
>
> Caller metadata with 1-32 character keys and 1-512 character values.
>
> **requests** `array`
>
> Inline batch requests.
>
> **input\_files** `array`
>
> Uploaded JSONL file UUIDs containing batch requests.
>
> **timeout\_hours** `integer`
>
> Batch timeout in hours.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Chat Completion
>
> **Slug:** `MISTRAL_AI_CREATE_CHAT_COMPLETION`
>
> Generate conversational responses from Mistral AI models with function calling and various model parameters. Responses are non-streaming.
>
> #### Input Parameters
>
> **n** `integer`
>
> Number of completions to return for each request. Input tokens are only billed once. Useful for generating multiple variations.
>
> **stop** `string`
>
> Stop generation if this token/string is detected. Can be a single string or list of strings.
>
> **model** `string` *required*
>
> ID of the model to use. Use the List Available Models API to see available models (e.g., 'mistral-tiny', 'mistral-small', 'mistral-medium', 'mistral-large-latest').
>
> **tools** `array`
>
> List of tools (functions) the model may call. Each tool should have 'type', 'function' with 'name', 'description', and 'parameters' (JSON schema).
>
> **top\_p** `number`
>
> Nucleus sampling probability mass. The model considers tokens with top\_p probability mass. Default 1.0. We recommend altering this or temperature but not both.
>
> **stream** `boolean`
>
> Whether to stream back partial progress as server-sent events. When true, tokens are sent as they become available. Default false.
>
> **messages** `array` *required*
>
> List of messages in the conversation. Each message has a 'role' (system/user/assistant/tool) and 'content'.
>
> **metadata** `object`
>
> Optional metadata to include with the request for tracking or logging purposes.
>
> **max\_tokens** `integer`
>
> Maximum number of tokens to generate in the completion. Prompt tokens plus max\_tokens cannot exceed the model's context length.
>
> **prediction** `object`
>
> Expected completion for optimizing response times.
>
> **prompt\_mode** `string`
>
> Toggle between reasoning mode and no system prompt. When set to 'reasoning', the system prompt for reasoning models will be used.
>
> **random\_seed** `integer`
>
> Seed for random sampling. If set, different calls will generate deterministic results (same input = same output).
>
> **safe\_prompt** `boolean`
>
> Whether to inject a safety prompt before all conversations to reduce harmful outputs. Default false.
>
> **temperature** `number`
>
> Sampling temperature between 0.0 and 1.0. Higher values (e.g., 0.7) make output more random, lower values (e.g., 0.2) make it more focused and deterministic. Recommended range: 0.0-0.7.
>
> **tool\_choice** `string`
>
> Controls which tool is called by the model. 'none' means no tool calls, 'auto' lets model decide, 'any'/'required' means must call a tool. Or specify a tool: \{"type": "function", "function": \{"name": "my\_function"}}. Default 'auto'.
>
> **response\_format** `object`
>
> Format specification for model output.
>
> **presence\_penalty** `number`
>
> Penalizes word/phrase repetition regardless of frequency. Range: -2.0 to 2.0. Higher values encourage more diverse vocabulary. Default 0.0.
>
> **frequency\_penalty** `number`
>
> Penalizes word repetition based on frequency in the generated text. Range: -2.0 to 2.0. Higher values discourage repetition. Default 0.0.
>
> **parallel\_tool\_calls** `boolean`
>
> Whether to enable parallel function calling during tool use. When enabled, the model can call multiple tools simultaneously. Default true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Chat Moderation
>
> **Slug:** `MISTRAL_AI_CREATE_CHAT_MODERATION`
>
> Tool to classify chat content for moderation purposes across 9 categories. Use when you need to detect harmful content, inappropriate messages, or policy violations in chat conversations.
>
> #### Input Parameters
>
> **input** `array` *required*
>
> Array of message objects to classify. Each message has a 'role' (user/assistant) and 'content' (string). The last user message will be classified for moderation.
>
> **model** `string`
>
> Moderation model to use for classification. Use 'mistral-moderation-latest' for the most recent version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Embeddings
>
> **Slug:** `MISTRAL_AI_CREATE_EMBEDDINGS`
>
> Tool to generate vector embeddings for input text using Mistral AI embedding models. Use when you need to convert text into numerical vectors for semantic search, similarity comparison, or RAG applications.
>
> #### Input Parameters
>
> **input** `string` *required*
>
> The text content to be embedded. Can be a single string or an array of strings for batch processing.
>
> **model** `string` *required*
>
> The ID of the model to be used for embedding (e.g., 'mistral-embed').
>
> **output\_dtype** `string ("float" | "int8" | "uint8" | "binary" | "ubinary")`
>
> Output data type for embeddings.
>
> **encoding\_format** `string ("float" | "base64")`
>
> Output encoding format for embeddings.
>
> **output\_dimension** `integer`
>
> The dimension of the output embeddings when feature available. If not provided, a default output dimension will be used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create FIM Completion
>
> **Slug:** `MISTRAL_AI_CREATE_FIM_COMPLETION`
>
> Generate code completions using fill-in-the-middle functionality. Use when you need to complete code between a prefix and suffix, or continue code from a prompt. Ideal for code completion, function implementation, and context-aware code generation.
>
> #### Input Parameters
>
> **stop** `string`
>
> Stop generation if this token is detected. Can be a single string or an array of strings. When provided as array, generation stops if any of the tokens is detected.
>
> **model** `string`
>
> ID of the model with FIM capability to use. Default: codestral-latest.
>
> **top\_p** `number`
>
> Nucleus sampling probability mass. The model considers tokens with top\_p probability mass. For example, 0.1 means only tokens comprising the top 10% probability mass are considered. Default 1.0. Generally recommend altering this or temperature but not both.
>
> **prompt** `string` *required*
>
> The text/code to complete. This is the prefix that comes before the gap to be filled.
>
> **stream** `boolean`
>
> This parameter is not supported and will always be set to false. Streaming responses are not handled by this action.
>
> **suffix** `string`
>
> Optional text/code that adds more context for the model. When given both prompt and suffix, the model fills what is between them. When suffix is not provided, the model simply executes completion starting with prompt.
>
> **max\_tokens** `integer`
>
> Maximum number of tokens to generate in the completion. The token count of prompt plus max\_tokens cannot exceed the model's context length.
>
> **random\_seed** `integer`
>
> Seed for random sampling. If set, different calls will generate deterministic results. Use for reproducible completions.
>
> **temperature** `number`
>
> Sampling temperature between 0.0 and 1.0. Higher values like 0.7 make output more random, lower values like 0.2 make it more focused and deterministic. Recommended range: 0.0-0.7. Generally recommend altering this or top\_p but not both.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create library
>
> **Slug:** `MISTRAL_AI_CREATE_LIBRARY`
>
> Tool to create a new document library. Use when you need to group documents into a new library. Use after confirming authentication.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the new document library
>
> **description** `string`
>
> Optional description of the new document library
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create library share
>
> **Slug:** `MISTRAL_AI_CREATE_LIBRARY_SHARE`
>
> Create or update sharing permissions for a library. Use to grant access to users, workspaces, or organizations. Specify the access level (Viewer or Editor) and the entity to share with. This is a beta endpoint.
>
> #### Input Parameters
>
> **level** `string ("Viewer" | "Editor")` *required*
>
> Access level to grant: 'Viewer' for read-only access or 'Editor' for read and write access
>
> **org\_id** `string`
>
> Optional organization ID to associate with the share (UUID format)
>
> **library\_id** `string` *required*
>
> Unique identifier of the library to share (UUID format)
>
> **share\_with\_type** `string ("User" | "Workspace" | "Org")` *required*
>
> The type of entity to share the library with: 'User' for individual users, 'Workspace' for team workspaces, or 'Org' for entire organizations
>
> **share\_with\_uuid** `string` *required*
>
> The UUID of the entity (user, workspace, or organization) to share the library with
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Moderation
>
> **Slug:** `MISTRAL_AI_CREATE_MODERATION`
>
> Tool to classify text content for moderation purposes across 9 categories. Use when you need to detect harmful content, inappropriate text, or policy violations in raw text inputs.
>
> #### Input Parameters
>
> **input** `string` *required*
>
> Text to classify for moderation. Can be a single string or an array of strings for batch processing.
>
> **model** `string`
>
> Moderation model to use for classification. Use 'mistral-moderation-latest' for the most recent version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create OCR
>
> **Slug:** `MISTRAL_AI_CREATE_OCR`
>
> Extract text and structured data from images and documents using Mistral AI OCR, including tables, headers, footers, and custom structured extraction. Managed OCR requires mistral-ocr-4-1 and direct URLs, limits page selections to 1–10 distinct nonnegative indexes, and does not support annotation add-ons.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.004 per standard OCR 4.1 page
>
> #### Input Parameters
>
> **id** `string`
>
> Optional custom identifier for this OCR request.
>
> **model** `string` *required*
>
> Model to use for OCR processing. Use 'mistral-ocr-latest' for the latest version or specific version like 'mistral-ocr-2512'.
>
> **pages** `array`
>
> Specific pages to process (0-indexed). Can be single numbers, ranges, or lists. If not specified, all pages are processed.
>
> **document** `string` *required*
>
> Document to run OCR on. Can be an image URL, document URL, or file ID of a previously uploaded file.
>
> **image\_limit** `integer`
>
> Maximum number of images to extract from the document.
>
> **table\_format** `string ("markdown" | "html")`
>
> Format for extracted tables.
>
> **extract\_footer** `boolean`
>
> Whether to extract footer content from the document. Default false.
>
> **extract\_header** `boolean`
>
> Whether to extract header content from the document. Default false.
>
> **image\_min\_size** `integer`
>
> Minimum height and width (in pixels) for images to extract. Smaller images are ignored.
>
> **include\_image\_base64** `boolean`
>
> Whether to include base64-encoded image data in the response.
>
> **bbox\_annotation\_format** `object`
>
> Response format specification for structured output.
>
> **document\_annotation\_format** `object`
>
> Response format specification for structured output.
>
> **document\_annotation\_prompt** `string`
>
> Optional prompt to guide the model in extracting structured output from the entire document. Requires document\_annotation\_format to be provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create or Update Agent Alias
>
> **Slug:** `MISTRAL_AI_CREATE_OR_UPDATE_AGENT_ALIAS`
>
> Tool to create or update an agent version alias. Use when you need to assign a version alias (like 'production' or 'staging') to a specific agent version.
>
> #### Input Parameters
>
> **alias** `string` *required*
>
> Name of the version alias (e.g., 'production', 'staging', 'latest').
>
> **version** `integer` *required*
>
> Agent version number to assign to this alias. Must be a non-negative integer.
>
> **agent\_id** `string` *required*
>
> Unique identifier of the agent (UUID format).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Speech
>
> **Slug:** `MISTRAL_AI_CREATE_SPEECH`
>
> Generate JSON-encoded speech audio from text without streaming.
>
> #### Input Parameters
>
> **input** `string` *required*
>
> Text to generate speech from.
>
> **model** `string` *required*
>
> Speech model identifier, such as voxtral-mini-tts-latest.
>
> **voice\_id** `string`
>
> Preset or custom voice used to generate speech.
>
> **ref\_audio** `string`
>
> Base64-encoded reference audio for zero-shot voice cloning.
>
> **response\_format** `string ("pcm" | "wav" | "mp3" | "flac" | "opus")`
>
> Output audio format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete agent
>
> **Slug:** `MISTRAL_AI_DELETE_AGENT`
>
> Permanently deletes an agent by its ID (Beta feature). Use this tool when you need to remove an agent that is no longer needed. This operation is irreversible - the agent will be permanently removed from the system.
>
> #### Input Parameters
>
> **agent\_id** `string` *required*
>
> The unique identifier of the agent to delete. This should be the agent ID returned from previous agent operations (e.g., ag\_019c5ecefcc37282b0fff41b4b3a8f5d).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Conversation
>
> **Slug:** `MISTRAL_AI_DELETE_CONVERSATION`
>
> Tool to delete a conversation by its ID (Beta). Use when you need to permanently remove a conversation. This is a beta feature.
>
> #### Input Parameters
>
> **conversation\_id** `string` *required*
>
> ID of the conversation to delete. Must be a valid conversation ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete File
>
> **Slug:** `MISTRAL_AI_DELETE_FILE`
>
> Delete a file by its ID from Mistral AI. Permanently removes the file and its metadata. Use List Files action first to obtain valid file IDs.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> UUID of the file to delete. Obtain file IDs from the List Files action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete library
>
> **Slug:** `MISTRAL_AI_DELETE_LIBRARY`
>
> Permanently delete a library and its documents from Mistral AI. The response may contain deleted library details, or only the library ID when no details are returned.
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique UUID identifier of the library to delete. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete library document
>
> **Slug:** `MISTRAL_AI_DELETE_LIBRARY_DOCUMENT`
>
> Permanently deletes a document from a Mistral AI library. Use this tool when you need to remove a specific document from a library. Both library\_id and document\_id must be valid UUIDs. This operation is irreversible - the document will be permanently removed. Returns an empty response on success (HTTP 204). Common errors: - 404: Document not found (already deleted or invalid document\_id) - 422: Invalid UUID format for library\_id or document\_id
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique UUID identifier of the library containing the document. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> **document\_id** `string` *required*
>
> The unique UUID identifier of the document to delete. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete library share
>
> **Slug:** `MISTRAL_AI_DELETE_LIBRARY_SHARE`
>
> Remove sharing permissions for a library from a user, workspace, or organization. Use when you need to revoke access to a library that was previously shared. This is a beta feature.
>
> #### Input Parameters
>
> **org\_id** `string`
>
> Optional organization ID for scoping the operation.
>
> **library\_id** `string` *required*
>
> The unique UUID identifier of the library to remove sharing permissions from. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> **share\_with\_type** `string ("User" | "Workspace" | "Org")` *required*
>
> The type of entity (User, Workspace, or Org) to revoke access from.
>
> **share\_with\_uuid** `string` *required*
>
> The UUID of the entity (user, workspace or organization) to revoke access from. Must be a valid UUID format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download File
>
> **Slug:** `MISTRAL_AI_DOWNLOAD_FILE`
>
> Download the content of a previously uploaded Mistral AI file by ID. Returns the file as a downloadable object for processing, such as training data for fine-tuning.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The unique identifier (UUID) of the file to download. Obtain this from the list\_files or upload\_file actions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agent
>
> **Slug:** `MISTRAL_AI_GET_AGENT`
>
> Tool to retrieve details of a specific Mistral AI agent by its ID. Returns comprehensive agent information including model, instructions, tools, and configuration. Use when you need to inspect or verify an agent's settings.
>
> #### Input Parameters
>
> **agent\_id** `string` *required*
>
> UUID of the agent to retrieve. Obtain agent IDs from the List Agents action.
>
> **agent\_version** `string`
>
> Specific version of the agent to retrieve. If not provided, the latest version is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agent Version
>
> **Slug:** `MISTRAL_AI_GET_AGENT_VERSION`
>
> Retrieve a specific version of an agent (Beta). Use when you need to get details about a particular agent version, including its configuration, tools, and metadata.
>
> #### Input Parameters
>
> **version** `string` *required*
>
> Version number of the agent to retrieve (e.g., '0', '1', '2').
>
> **agent\_id** `string` *required*
>
> UUID of the agent to retrieve. Obtain agent IDs from the List Agents action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Batch Job
>
> **Slug:** `MISTRAL_AI_GET_BATCH_JOB`
>
> Get details and optionally inline results for a batch job.
>
> #### Input Parameters
>
> **inline** `boolean`
>
> Return job results inline in the outputs field.
>
> **job\_id** `string` *required*
>
> Batch job UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get campaign
>
> **Slug:** `MISTRAL_AI_GET_CAMPAIGN`
>
> Retrieve an observability campaign by its UUID.
>
> #### Input Parameters
>
> **campaign\_id** `string` *required*
>
> UUID of the campaign to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get campaign status
>
> **Slug:** `MISTRAL_AI_GET_CAMPAIGN_STATUS`
>
> Return the execution status of an observability campaign.
>
> #### Input Parameters
>
> **campaign\_id** `string` *required*
>
> UUID of the campaign whose status should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Chat Completion Event
>
> **Slug:** `MISTRAL_AI_GET_CHAT_COMPLETION_EVENT`
>
> Retrieve one observability chat completion event by UUID.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> UUID of the chat completion event to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Chat Completion Field Options
>
> **Slug:** `MISTRAL_AI_GET_CHAT_COMPLETION_FIELD_OPTIONS`
>
> Get available values for a chat completion field and filter operator.
>
> #### Input Parameters
>
> **operator** `string ("lt" | "lte" | "gt" | "gte" | "startswith" | "istartswith" | "endswith" | "iendswith" | "contains" | "icontains" | "matches" | "notcontains" | "inotcontains" | "eq" | "neq" | "isnull" | "includes" | "excludes" | "len_eq")` *required*
>
> Operator for which options are requested.
>
> **field\_name** `string` *required*
>
> Chat completion field whose options to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Connector
>
> **Slug:** `MISTRAL_AI_GET_CONNECTOR`
>
> Get a connector by ID or name without requesting customer data or secrets.
>
> #### Input Parameters
>
> **connector\_id\_or\_name** `string` *required*
>
> Connector UUID or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Connector Authentication Methods
>
> **Slug:** `MISTRAL_AI_GET_CONNECTOR_AUTHENTICATION_METHODS`
>
> Get a connector's public authentication methods and required headers.
>
> #### Input Parameters
>
> **connector\_id\_or\_name** `string` *required*
>
> Connector UUID or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversation
>
> **Slug:** `MISTRAL_AI_GET_CONVERSATION`
>
> Tool to retrieve details of a specific conversation. Use when you need to fetch conversation metadata including timestamps, configuration, and associated model or agent information.
>
> #### Input Parameters
>
> **conversation\_id** `string` *required*
>
> ID of the conversation from which we are fetching metadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversation History
>
> **Slug:** `MISTRAL_AI_GET_CONVERSATION_HISTORY`
>
> Retrieve the full history of a conversation in Mistral AI. Returns all entries including messages, tool calls, function results, and agent handoffs. Use this to review conversation context or export conversation data. Note: This is a beta endpoint.
>
> #### Input Parameters
>
> **conversation\_id** `string` *required*
>
> ID of the conversation from which we are fetching entries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversation Messages
>
> **Slug:** `MISTRAL_AI_GET_CONVERSATION_MESSAGES`
>
> Retrieve all messages from a Mistral AI conversation. Use when you need to fetch the complete message history for a specific conversation.
>
> #### Input Parameters
>
> **conversation\_id** `string` *required*
>
> ID of the conversation from which to fetch messages. This is a unique identifier for the conversation in Mistral AI's system.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get dataset
>
> **Slug:** `MISTRAL_AI_GET_DATASET`
>
> Retrieve an observability dataset by its UUID.
>
> #### Input Parameters
>
> **dataset\_id** `string` *required*
>
> UUID of the dataset to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get dataset import task
>
> **Slug:** `MISTRAL_AI_GET_DATASET_IMPORT_TASK`
>
> Retrieve the status and progress of one dataset import task.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> UUID of the import task to retrieve.
>
> **dataset\_id** `string` *required*
>
> UUID of the dataset associated with the import task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get dataset record
>
> **Slug:** `MISTRAL_AI_GET_DATASET_RECORD`
>
> Retrieve a conversation record from an observability dataset.
>
> #### Input Parameters
>
> **dataset\_record\_id** `string` *required*
>
> UUID of the dataset record to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get document extracted text URL
>
> **Slug:** `MISTRAL_AI_GET_DOCUMENT_EXTRACTED_TEXT_URL`
>
> Retrieve a signed URL to download the extracted text from a document in a Mistral AI library. This is a beta endpoint. Note: Only documents that undergo OCR processing (such as PDFs) will have extracted text available; plain text files that don't require OCR will return a 404 error.
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique UUID identifier of the library containing the document. Use MISTRAL\_AI\_LIST\_LIBRARIES to get available library IDs.
>
> **document\_id** `string` *required*
>
> The unique UUID identifier of the document. Use MISTRAL\_AI\_LIST\_LIBRARY\_DOCUMENTS to get document IDs. Note: Only documents that undergo OCR processing (e.g., PDFs) will have extracted text available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get document signed URL
>
> **Slug:** `MISTRAL_AI_GET_DOCUMENT_SIGNED_URL`
>
> Get a signed URL to download a document from a Mistral AI library. Returns a temporary URL that provides direct access to download the document content. Use this when you need to retrieve document files from a library. The signed URL is typically valid for 30 minutes.
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique UUID identifier of the library containing the document. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> **document\_id** `string` *required*
>
> The unique UUID identifier of the document to retrieve the signed URL for. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Document Status
>
> **Slug:** `MISTRAL_AI_GET_DOCUMENT_STATUS`
>
> Retrieve the processing status of a document in a Mistral AI library. Use this to check if a document has finished processing after upload. Returns the document ID and its current processing status.
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique identifier (UUID) for the document library. Obtain this from the List Libraries action or from the library URL in Le Chat.
>
> **document\_id** `string` *required*
>
> The unique identifier (UUID) for the document. Obtain this from the List Library Documents action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Document Text Content
>
> **Slug:** `MISTRAL_AI_GET_DOCUMENT_TEXT_CONTENT`
>
> Retrieve the extracted text content of a specific document from a Mistral AI library (Beta). Returns the full text content extracted from the document. Use the List Libraries action first to obtain valid library IDs, then use List Library Documents to get document IDs.
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique identifier (UUID) for the document library. Obtain this from the List Libraries action or from the library URL in Le Chat.
>
> **document\_id** `string` *required*
>
> The unique identifier (UUID) for the document. Obtain this from the List Library Documents action or from the document URL in Le Chat.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get File Signed URL
>
> **Slug:** `MISTRAL_AI_GET_FILE_SIGNED_URL`
>
> Get a time-limited signed URL for downloading a file from Mistral AI. Use when you need a temporary download link that can be shared or used externally. The URL expires after the specified number of hours (default 24).
>
> #### Input Parameters
>
> **expiry** `integer`
>
> Number of hours before the URL becomes invalid. Defaults to 24 hours if not specified.
>
> **file\_id** `string` *required*
>
> UUID of the file to get signed URL for. Obtain file IDs from the List Files action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Fine Tuning Jobs
>
> **Slug:** `MISTRAL_AI_GET_FINE_TUNING_JOBS`
>
> List fine-tuning jobs with optional filtering and pagination. Use this tool to retrieve all fine-tuning jobs for your organization. Supports filtering by model, status, creation time, and W\&B integration. Results are paginated; use 'page' and 'page\_size' to navigate large result sets.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return (0-indexed). Default is 0.
>
> **model** `string`
>
> Filter by the base model name used for fine-tuning. When set, only jobs using this model are returned.
>
> **status** `string`
>
> Filter by the current job status. Valid values: QUEUED, STARTED, VALIDATING, VALIDATED, RUNNING, FAILED\_VALIDATION, FAILED, SUCCESS, CANCELLED, CANCELLATION\_REQUESTED.
>
> **suffix** `string`
>
> Filter by the model suffix used when creating the fine-tuned model.
>
> **page\_size** `integer`
>
> Number of fine-tuning jobs to return per page (1-1000). Default is 100.
>
> **wandb\_name** `string`
>
> Filter by the Weights and Biases run name.
>
> **created\_after** `string`
>
> Filter to return only jobs created after this date/time (ISO 8601 format).
>
> **created\_by\_me** `boolean`
>
> When set to true, only return jobs created by the API caller. Default is false.
>
> **wandb\_project** `string`
>
> Filter by the Weights and Biases project name.
>
> **created\_before** `string`
>
> Filter to return only jobs created before this date/time (ISO 8601 format).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Judge
>
> **Slug:** `MISTRAL_AI_GET_JUDGE`
>
> Retrieve a saved observability judge by UUID.
>
> #### Input Parameters
>
> **judge\_id** `string` *required*
>
> UUID of the saved judge to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get library
>
> **Slug:** `MISTRAL_AI_GET_LIBRARY`
>
> Retrieve detailed information about a specific library. Returns complete library metadata including name, description, document counts, size, timestamps, and ownership details. Use List Libraries action first to obtain valid library IDs.
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> UUID of the library to retrieve. Obtain library IDs from the List Libraries action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Library Document
>
> **Slug:** `MISTRAL_AI_GET_LIBRARY_DOCUMENT`
>
> Retrieve metadata for a specific document in a Mistral AI library. Returns detailed information including processing status, size, summary, token counts, and timestamps. Use this to check document status after upload or to retrieve details for a known document.
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique identifier (UUID) for the document library. Obtain this from the List Libraries action or from the library URL in Le Chat.
>
> **document\_id** `string` *required*
>
> The unique identifier (UUID) for the document. Obtain this from the List Library Documents action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Model
>
> **Slug:** `MISTRAL_AI_GET_MODEL`
>
> Tool to retrieve detailed information about a specific Mistral AI model by its ID. Returns model metadata including capabilities, context length, and ownership. Use when you need to inspect model specifications before using it.
>
> #### Input Parameters
>
> **model\_id** `string` *required*
>
> The ID of the model to retrieve. Use model identifiers like 'mistral-small-latest', 'mistral-large-latest', or fine-tuned model IDs in format 'ft:open-mistral-7b:587a6b29:20240514:7e773925'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Similar Chat Completion Events
>
> **Slug:** `MISTRAL_AI_GET_SIMILAR_CHAT_COMPLETION_EVENTS`
>
> Retrieve observability events similar to a specified event.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> UUID of the event for which to find similar events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Voice
>
> **Slug:** `MISTRAL_AI_GET_VOICE`
>
> Get saved voice metadata without sample audio.
>
> #### Input Parameters
>
> **voice\_id** `string` *required*
>
> Voice identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Voice Sample
>
> **Slug:** `MISTRAL_AI_GET_VOICE_SAMPLE`
>
> Download a saved voice's sample as a WAV audio file.
>
> #### Input Parameters
>
> **voice\_id** `string` *required*
>
> Voice identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW`
>
> Retrieve a workflow definition and its active-worker status by name or ID.
>
> #### Input Parameters
>
> **workflow\_identifier** `string` *required*
>
> Workflow name or ID to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Deployment
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_DEPLOYMENT`
>
> Retrieve a workflow deployment and its registered workers.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the deployment to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Execution
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_EXECUTION`
>
> Retrieve the current state and result of a workflow execution.
>
> #### Input Parameters
>
> **execution\_id** `string` *required*
>
> ID of the workflow execution to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Execution History
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_EXECUTION_HISTORY`
>
> Retrieve the event history for a workflow execution.
>
> #### Input Parameters
>
> **execution\_id** `string` *required*
>
> ID of the workflow execution whose history to retrieve.
>
> **decode\_payloads** `boolean`
>
> Whether to decode payloads in the returned history.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Execution OpenTelemetry Trace
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_EXECUTION_OTEL_TRACE`
>
> Retrieve raw OpenTelemetry trace data for a workflow execution.
>
> #### Input Parameters
>
> **execution\_id** `string` *required*
>
> ID of the workflow execution whose OpenTelemetry trace to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Execution Trace Events
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_EXECUTION_TRACE_EVENTS`
>
> Retrieve trace events for a workflow execution.
>
> #### Input Parameters
>
> **execution\_id** `string` *required*
>
> ID of the workflow execution whose trace events to retrieve.
>
> **merge\_same\_id\_events** `boolean`
>
> Whether to merge events that share the same ID.
>
> **include\_internal\_events** `boolean`
>
> Whether to include internal trace events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Execution Trace Summary
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_EXECUTION_TRACE_SUMMARY`
>
> Retrieve a hierarchical trace summary for a workflow execution.
>
> #### Input Parameters
>
> **execution\_id** `string` *required*
>
> ID of the workflow execution whose trace summary to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Metrics
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_METRICS`
>
> Retrieve aggregate execution, error, latency, and retry metrics for a workflow.
>
> #### Input Parameters
>
> **end\_time** `string`
>
> Only include workflows started before this ISO 8601 time.
>
> **start\_time** `string`
>
> Only include workflows started after this ISO 8601 time.
>
> **workflow\_name** `string` *required*
>
> Name of the workflow whose metrics to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Registration
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_REGISTRATION`
>
> Retrieve one workflow registration and its worker availability.
>
> #### Input Parameters
>
> **with\_workflow** `boolean`
>
> Whether to include the workflow definition.
>
> **include\_shared** `boolean`
>
> Whether to include shared workflow registrations.
>
> **workflow\_registration\_id** `string` *required*
>
> UUID of the workflow registration to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Run
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_RUN`
>
> Retrieve a workflow run's status, timing, execution IDs, and result.
>
> #### Input Parameters
>
> **run\_id** `string` *required*
>
> UUID of the workflow run to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Run History
>
> **Slug:** `MISTRAL_AI_GET_WORKFLOW_RUN_HISTORY`
>
> Retrieve the event history for a workflow run.
>
> #### Input Parameters
>
> **run\_id** `string` *required*
>
> UUID of the workflow run whose history to retrieve.
>
> **decode\_payloads** `boolean`
>
> Whether to decode payloads in the returned history.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Judge Chat Completion Event
>
> **Slug:** `MISTRAL_AI_JUDGE_CHAT_COMPLETION_EVENT`
>
> Evaluate one chat completion event with an inline judge definition.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> UUID of the chat completion event to evaluate.
>
> **judge\_definition** `object` *required*
>
> Inline judge with name, description, model\_name, instructions, tools, and output. Output is CLASSIFICATION with value/description options or REGRESSION with numeric min/max descriptions. Example: `{"name":"Helpfulness judge","description":"Checks helpfulness","model_name":"mistral-small-latest","output":{"type":"CLASSIFICATION","options":[{"value":"helpful","description":"The response is helpful"}]},"instructions":"Classify the response","tools":[]}`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Judge Conversation
>
> **Slug:** `MISTRAL_AI_JUDGE_CONVERSATION`
>
> Run a saved observability judge against a supplied conversation.
>
> #### Input Parameters
>
> **judge\_id** `string` *required*
>
> UUID of the saved judge to run.
>
> **messages** `array` *required*
>
> Conversation messages to evaluate, for example `[{"role": "user", "content": "Hello"}]`. Message objects may include additional fields accepted by the judge.
>
> **properties** `object`
>
> Optional properties supplied to the judge.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Judge dataset record
>
> **Slug:** `MISTRAL_AI_JUDGE_DATASET_RECORD`
>
> Evaluate one dataset record with a supplied non-durable judge definition.
>
> #### Input Parameters
>
> **judge\_definition** `object` *required*
>
> Non-durable judge with name, description, model\_name, instructions, tools, and output. Output is CLASSIFICATION with value/description options or REGRESSION with numeric min/max descriptions. Example: `{"name":"Quality judge","description":"Scores quality","model_name":"mistral-small-latest","output":{"type":"REGRESSION","min":0,"min_description":"Poor","max":1,"max_description":"Excellent"},"instructions":"Score response quality","tools":[]}`.
>
> **dataset\_record\_id** `string` *required*
>
> UUID of the dataset record to evaluate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List agent aliases
>
> **Slug:** `MISTRAL_AI_LIST_AGENT_ALIASES`
>
> List version aliases for a specified agent (Beta), including the version associated with each alias.
>
> #### Input Parameters
>
> **agent\_id** `string` *required*
>
> Unique identifier of the agent. Obtain agent IDs from the List Agents action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Agents
>
> **Slug:** `MISTRAL_AI_LIST_AGENTS`
>
> List configured agents available in your organization (Beta), with optional filters and pagination.
>
> #### Input Parameters
>
> **id** `string`
>
> Filter agents by ID.
>
> **name** `string`
>
> Filter agents by name.
>
> **page** `integer`
>
> Page number (0-indexed) for pagination. Default is 0.
>
> **sources** `string`
>
> Filter agents by source.
>
> **metadata** `string`
>
> Filter agents by metadata.
>
> **page\_size** `integer`
>
> Number of agents to return per page. Default is 20.
>
> **deployment\_chat** `boolean`
>
> Filter agents by deployment chat setting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Agent Versions
>
> **Slug:** `MISTRAL_AI_LIST_AGENT_VERSIONS`
>
> List versions of a specific agent (Beta) to view its version history. Results are paginated.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (0-indexed). Default is 0.
>
> **agent\_id** `string` *required*
>
> Unique identifier of the agent to retrieve versions for.
>
> **page\_size** `integer`
>
> Number of versions to return per page. Default is 20.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Batch Jobs
>
> **Slug:** `MISTRAL_AI_LIST_BATCH_JOBS`
>
> Tool to retrieve a list of all batch jobs with optional filtering and pagination. Use when you need to view or manage batch processing jobs.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return (0-indexed). Default is 0.
>
> **model** `string`
>
> Filter by the model name used for batch processing. When set, only jobs using this model are returned.
>
> **status** `string`
>
> Filter by the current batch job status. Valid values include: QUEUED, RUNNING, SUCCESS, FAILED, CANCELLED.
>
> **agent\_id** `string`
>
> Filter by agent ID. When set, only batch jobs associated with this agent are returned.
>
> **metadata** `string`
>
> Filter by metadata string. When set, only batch jobs with matching metadata are returned.
>
> **page\_size** `integer`
>
> Number of batch jobs to return per page (1-1000). Default is 100.
>
> **created\_after** `string`
>
> Filter to return only jobs created after this date/time (ISO 8601 format).
>
> **created\_by\_me** `boolean`
>
> When set to true, only return batch jobs created by the API caller. Default is false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List campaigns
>
> **Slug:** `MISTRAL_AI_LIST_CAMPAIGNS`
>
> List observability campaigns, optionally filtering them by a text query.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to return.
>
> **query** `string`
>
> Optional text query used to filter campaigns.
>
> **page\_size** `integer`
>
> Maximum campaigns to return on this page (0-100).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List campaign selected events
>
> **Slug:** `MISTRAL_AI_LIST_CAMPAIGN_SELECTED_EVENTS`
>
> List chat-completion events selected by an observability campaign.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to return.
>
> **page\_size** `integer`
>
> Maximum selected events to return on this page (0-100).
>
> **campaign\_id** `string` *required*
>
> UUID of the campaign whose selected events should be listed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Chat Completion Fields
>
> **Slug:** `MISTRAL_AI_LIST_CHAT_COMPLETION_FIELDS`
>
> List fields and operators available for observability event filtering.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Connectors
>
> **Slug:** `MISTRAL_AI_LIST_CONNECTORS`
>
> List custom MCP connectors without returning connection secrets.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Cursor from the previous page.
>
> **page\_size** `integer`
>
> Connectors per page.
>
> **query\_filters** `object`
>
> Non-secret connector filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Connector Tools
>
> **Slug:** `MISTRAL_AI_LIST_CONNECTOR_TOOLS`
>
> List tools exposed by an MCP connector.
>
> #### Input Parameters
>
> **page** `integer`
>
> One-indexed result page.
>
> **pretty** `boolean`
>
> Return the provider's simplified tool shape.
>
> **refresh** `boolean`
>
> Refresh tools from the MCP server.
>
> **page\_size** `integer`
>
> Tools per page.
>
> **credentials\_name** `string`
>
> Named connector credentials to use for discovery.
>
> **connector\_id\_or\_name** `string` *required*
>
> Connector UUID or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Conversations
>
> **Slug:** `MISTRAL_AI_LIST_CONVERSATIONS`
>
> List all created conversations (Beta). Use to retrieve conversation history or manage existing conversations. Supports pagination and metadata filtering.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return (0-indexed). Default is 0.
>
> **metadata** `string`
>
> Filter conversations by metadata. Exact format depends on your metadata structure.
>
> **page\_size** `integer`
>
> Number of conversations to return per page (1-1000). Default is 100.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List dataset import tasks
>
> **Slug:** `MISTRAL_AI_LIST_DATASET_IMPORT_TASKS`
>
> List import tasks associated with an observability dataset.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to return.
>
> **page\_size** `integer`
>
> Maximum import tasks to return on this page (0-100).
>
> **dataset\_id** `string` *required*
>
> UUID of the dataset whose import tasks should be listed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List dataset records
>
> **Slug:** `MISTRAL_AI_LIST_DATASET_RECORDS`
>
> List conversation records stored in an observability dataset.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to return.
>
> **page\_size** `integer`
>
> Maximum records to return on this page (0-100).
>
> **dataset\_id** `string` *required*
>
> UUID of the dataset whose records should be listed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List datasets
>
> **Slug:** `MISTRAL_AI_LIST_DATASETS`
>
> List observability datasets, optionally filtering them by a text query.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to return.
>
> **query** `string`
>
> Optional text query used to filter datasets.
>
> **page\_size** `integer`
>
> Maximum datasets to return on this page (0-100).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Files
>
> **Slug:** `MISTRAL_AI_LIST_FILES`
>
> Tool to list all files available to the user. Use when you need to view or manage uploaded files, supports pagination.
>
> #### Input Parameters
>
> **after** `string`
>
> Pagination cursor: file ID to start after. Use to retrieve the next page of results.
>
> **limit** `integer`
>
> Maximum number of files to return, must be >=1. Default is server-side limit.
>
> **order** `string ("asc" | "desc")`
>
> Order to list files: 'asc' for ascending or 'desc' for descending. Default 'desc'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Judges
>
> **Slug:** `MISTRAL_AI_LIST_JUDGES`
>
> List saved observability judges with filtering, search, and pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve.
>
> **query** `string`
>
> Text search applied to judges.
>
> **page\_size** `integer`
>
> Maximum judges per page (0-100).
>
> **type\_filter** `array`
>
> Judge output types to include.
>
> **model\_filter** `array`
>
> Model names to include.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List libraries
>
> **Slug:** `MISTRAL_AI_LIST_LIBRARIES`
>
> List all document libraries accessible to your organization. Returns library metadata including id, name, description, document counts, and timestamps. Use to discover available libraries before listing or uploading documents. Note: This is a beta endpoint.
>
> #### Input Parameters
>
> **limit** `integer`
>
> (Beta) Maximum number of libraries to return per page. May not be honored in beta.
>
> **page\_token** `string`
>
> (Beta) Token for fetching the next page of results. May not be honored in beta.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Library Documents
>
> **Slug:** `MISTRAL_AI_LIST_LIBRARY_DOCUMENTS`
>
> List all documents in a Mistral AI document library. Returns document metadata including name, processing status, size, summary, and timestamps. Use the List Libraries action first to obtain valid library IDs. Supports pagination for large libraries.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (0-indexed). Use with page\_size for pagination.
>
> **page\_size** `integer`
>
> Number of documents per page. Defaults to 100 if not specified.
>
> **library\_id** `string` *required*
>
> The unique identifier (UUID) for the document library. Obtain this from the List Libraries action or from the library URL in Le Chat.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List library shares
>
> **Slug:** `MISTRAL_AI_LIST_LIBRARY_SHARES`
>
> List all sharing permissions for a document library. Returns details about who has access to the library, including role, share type, and user/organization identifiers. Use the List Libraries action first to obtain valid library IDs. Note: This is a beta endpoint.
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique identifier (UUID) for the document library. Obtain this from the List Libraries action or from the library URL in Le Chat.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Models
>
> **Slug:** `MISTRAL_AI_LIST_MODELS`
>
> Tool to retrieve all available Mistral AI models including base models and fine-tuned models. Use when you need to see what models are available for chat completions, embeddings, or fine-tuning.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Voices
>
> **Slug:** `MISTRAL_AI_LIST_VOICES`
>
> List saved voices without sample audio data.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of voices to return.
>
> **offset** `integer`
>
> Pagination offset.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflow Deployments
>
> **Slug:** `MISTRAL_AI_LIST_WORKFLOW_DEPLOYMENTS`
>
> List workflow worker deployments, optionally filtering to active deployments or a workflow.
>
> #### Input Parameters
>
> **active\_only** `boolean`
>
> Whether to return only active deployments.
>
> **workflow\_name** `string`
>
> Filter deployments by workflow name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflow Events
>
> **Slug:** `MISTRAL_AI_LIST_WORKFLOW_EVENTS`
>
> List durable workflow lifecycle and task events with cursor pagination, filtered by a root workflow execution, workflow execution, or workflow run ID.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of events to return.
>
> **cursor** `string`
>
> Cursor returned by a previous page.
>
> **workflow\_run\_id** `string`
>
> Filter by workflow run ID.
>
> **workflow\_exec\_id** `string`
>
> Filter by workflow execution ID.
>
> **root\_workflow\_exec\_id** `string`
>
> Filter by root workflow execution ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflow Registrations
>
> **Slug:** `MISTRAL_AI_LIST_WORKFLOW_REGISTRATIONS`
>
> List workflow registrations with sharing, activity, archival, and cursor filters.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of registrations to return.
>
> **cursor** `string`
>
> Pagination cursor returned by a previous page.
>
> **archived** `boolean`
>
> False excludes archived, true returns only archived, and null includes all.
>
> **task\_queue** `string`
>
> Filter by task queue.
>
> **active\_only** `boolean`
>
> Whether to return only active workflow registrations.
>
> **workflow\_id** `string`
>
> Filter by workflow UUID.
>
> **with\_workflow** `boolean`
>
> Whether to include each workflow definition.
>
> **include\_shared** `boolean`
>
> Whether to include shared workflow registrations.
>
> **workflow\_search** `string`
>
> Filter by workflow name.
>
> **available\_in\_chat\_assistant** `boolean`
>
> Filter to workflows compatible with chat assistant.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflow Runs
>
> **Slug:** `MISTRAL_AI_LIST_WORKFLOW_RUNS`
>
> List workflow runs with status, search, and cursor pagination filters.
>
> #### Input Parameters
>
> **search** `string`
>
> Search by workflow name, display name, or ID.
>
> **status** `string`
>
> Filter by one or more workflow execution statuses.
>
> **page\_size** `integer`
>
> Number of runs to return per page.
>
> **next\_page\_token** `string`
>
> Token returned by a previous page.
>
> **workflow\_identifier** `string`
>
> Filter by workflow name or ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflow Schedules
>
> **Slug:** `MISTRAL_AI_LIST_WORKFLOW_SCHEDULES`
>
> List workflow schedules with timing, time zone, and execution policy details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Workflow Execution
>
> **Slug:** `MISTRAL_AI_QUERY_WORKFLOW_EXECUTION`
>
> Invoke a read-only query handler on a running workflow execution.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the workflow query handler to invoke.
>
> **input** `object`
>
> JSON object matching the selected query handler's input schema. Inspect the workflow definition to discover that handler-specific schema.
>
> **execution\_id** `string` *required*
>
> ID of the workflow execution to query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reprocess document
>
> **Slug:** `MISTRAL_AI_REPROCESS_DOCUMENT`
>
> Reprocess a document in a Mistral AI library (Beta). Use when you need to trigger reprocessing of a document, such as after updating library settings or to refresh document embeddings. Both library\_id and document\_id must be valid UUIDs. Returns an empty response on success (HTTP 204).
>
> #### Input Parameters
>
> **library\_id** `string` *required*
>
> The unique UUID identifier of the library containing the document. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> **document\_id** `string` *required*
>
> The unique UUID identifier of the document to reprocess. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restart Conversation
>
> **Slug:** `MISTRAL_AI_RESTART_CONVERSATION`
>
> Tool to restart a conversation from a specific point (Beta). Use when you need to branch a conversation or replay it from a particular message. Creates a new conversation starting from the specified entry.
>
> #### Input Parameters
>
> **store** `boolean`
>
> Whether to persist the conversation results to the server. Defaults to true
>
> **inputs** `string` *required*
>
> New input to append when restarting the conversation. Can be a string (simple text input) or an array of entry objects (MessageInputEntry, MessageOutputEntry, FunctionResultEntry, etc.)
>
> **stream** `boolean`
>
> Enable response streaming for real-time output. Defaults to false
>
> **metadata** `object`
>
> Additional metadata to associate with the restarted conversation
>
> **agent\_version** `string`
>
> Version of the agent to use when restarting the conversation
>
> **from\_entry\_id** `string` *required*
>
> ID of the entry from which to restart the conversation. The conversation will be recreated from this point
>
> **completion\_args** `object`
>
> White-listed arguments from the completion API to configure the response generation (e.g., temperature, max\_tokens)
>
> **conversation\_id** `string` *required*
>
> ID of the original conversation which is being restarted
>
> **handoff\_execution** `string ("client" | "server")`
>
> Handoff execution mode for agent handoffs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve File
>
> **Slug:** `MISTRAL_AI_RETRIEVE_FILE`
>
> Retrieve metadata of a file uploaded to Mistral AI. Returns file details including size, filename, purpose, and creation time. Use List Files action first to obtain valid file IDs.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> UUID of the file to retrieve. Obtain file IDs from the List Files action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Chat Completion Events
>
> **Slug:** `MISTRAL_AI_SEARCH_CHAT_COMPLETION_EVENTS`
>
> Search observability chat completion events and return previews or only IDs.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque cursor from a previous events result page; ignored for ids.
>
> **page\_size** `integer`
>
> Maximum events to return when result\_format is events (0-100).
>
> **extra\_fields** `array`
>
> Additional event fields to include in each result.
>
> **result\_format** `string ("events" | "ids")`
>
> Return full event previews or only matching event identifiers.
>
> **search\_params** `object` *required*
>
> Search object with required `filters`. Use a condition with `field`, `op`, and `value`, or nest conditions in `AND`/`OR` arrays. Example: `{"filters":{"AND":[{"field":"model","op":"eq","value":"mistral-large"}]}}`. Operators: lt, lte, gt, gte, startswith, istartswith, endswith, iendswith, contains, icontains, matches, notcontains, inotcontains, eq, neq, isnull, includes, excludes, len\_eq.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start Conversation
>
> **Slug:** `MISTRAL_AI_START_CONVERSATION`
>
> Tool to start a new conversation with a Mistral AI agent or base model. Use when initiating a conversational interaction that requires context tracking. Either 'model' or 'agent\_id' must be provided. Returns a conversation\_id for continuing the conversation.
>
> #### Input Parameters
>
> **name** `string`
>
> Name for the conversation to help identify it later.
>
> **model** `string`
>
> Specifies which base model to use. Either 'model' or 'agent\_id' must be set. Examples: 'mistral-small-latest', 'mistral-large-latest', 'mistral-medium-latest'.
>
> **store** `boolean`
>
> Whether to persist the conversation history. Set to false to prevent cloud storage. Default is true.
>
> **tools** `array`
>
> Available tools for the conversation (FunctionTool, WebSearchTool, CodeInterpreterTool, etc.). Array of tool definition objects.
>
> **inputs** `string` *required*
>
> The initial message(s) to append to the conversation. Can be a simple string or an array of entry objects with 'content' and 'role' fields.
>
> **stream** `boolean`
>
> Set true for streaming responses as Server-Sent Events. Default is false (returns complete JSON response).
>
> **agent\_id** `string`
>
> ID of an agent to use instead of a base model. Either 'model' or 'agent\_id' must be set.
>
> **metadata** `object`
>
> Custom key-value metadata to attach to the conversation for tracking or organization.
>
> **description** `string`
>
> Description of the conversation purpose or context.
>
> **instructions** `string`
>
> System instructions to guide the conversation behavior and style.
>
> **agent\_version** `string`
>
> Specific agent version to use. Only applicable when 'agent\_id' is specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unarchive Fine-Tuned Model
>
> **Slug:** `MISTRAL_AI_UNARCHIVE_FINE_TUNED_MODEL`
>
> Restore an archived fine-tuned model.
>
> #### Input Parameters
>
> **model\_id** `string` *required*
>
> Fine-tuned model identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Agent
>
> **Slug:** `MISTRAL_AI_UPDATE_AGENT`
>
> Tool to update an existing agent's configuration. Use when you need to modify an agent's name, description, model, instructions, tools, or other settings.
>
> #### Input Parameters
>
> **name** `string`
>
> Updated name for the agent
>
> **model** `string`
>
> Updated model to use for the agent (e.g., 'mistral-large-latest', 'mistral-small-latest')
>
> **tools** `array`
>
> Updated list of tools available to the model during conversation
>
> **agent\_id** `string` *required*
>
> The unique identifier of the agent to update
>
> **handoffs** `array`
>
> Updated list of handoff configurations
>
> **metadata** `object`
>
> Updated custom metadata to associate with the agent
>
> **description** `string`
>
> Updated description of the agent's purpose
>
> **instructions** `string`
>
> Updated instruction prompt the model will follow during the conversation
>
> **completion\_args** `object`
>
> White-listed arguments from the completion API.
>
> **deployment\_chat** `boolean`
>
> Updated flag indicating if agent is deployed for chat
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update agent version
>
> **Slug:** `MISTRAL_AI_UPDATE_AGENT_VERSION`
>
> Tool to update the current version of an agent (Beta). Use when you need to switch an agent to a different version from its available versions.
>
> #### Input Parameters
>
> **version** `integer` *required*
>
> Version number to set as the current version. Must be a non-negative integer from the agent's available versions list.
>
> **agent\_id** `string` *required*
>
> Unique identifier of the agent to update (e.g., 'ag\_019c5ecef27c7721a09ec60a67fceee5')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Fine-Tuned Model
>
> **Slug:** `MISTRAL_AI_UPDATE_FINE_TUNED_MODEL`
>
> Update the name or description of a fine-tuned model.
>
> #### Input Parameters
>
> **name** `string`
>
> New model name.
>
> **model\_id** `string` *required*
>
> Fine-tuned model identifier.
>
> **description** `string`
>
> New model description.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update library
>
> **Slug:** `MISTRAL_AI_UPDATE_LIBRARY`
>
> Tool to update an existing document library's properties. Use when you need to modify a library's name or description. Note: This is a beta endpoint.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the library. If not provided, the current name is retained.
>
> **library\_id** `string` *required*
>
> Unique identifier (UUID) of the library to update
>
> **description** `string`
>
> New description for the library. If not provided, the current description is retained.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update library document
>
> **Slug:** `MISTRAL_AI_UPDATE_LIBRARY_DOCUMENT`
>
> Update the metadata of a document in a Mistral AI library. Use this to modify a document's name or add/update custom attributes without re-uploading the file content. This is a beta endpoint.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the document. If provided, this will replace the current document name.
>
> **attributes** `object`
>
> Custom attributes to attach to the document as key-value pairs. Can be used to store metadata such as category, priority, tags, or any other relevant information.
>
> **library\_id** `string` *required*
>
> The unique UUID identifier of the library containing the document. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> **document\_id** `string` *required*
>
> The unique UUID identifier of the document to update. Must be a valid UUID format (e.g., xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload File
>
> **Slug:** `MISTRAL_AI_UPLOAD_FILE`
>
> Upload a file to Mistral AI for use in fine-tuning, batch processing, or OCR. Use this tool to: - Upload .jsonl files for fine-tuning models - Upload files for batch processing requests - Upload documents for OCR processing Maximum file size: 512 MB. For fine-tuning, only .jsonl files are supported.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File to upload to Mistral AI.
>
> **purpose** `string ("fine-tune" | "batch" | "ocr")`
>
> Purpose for the uploaded file.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Library Document
>
> **Slug:** `MISTRAL_AI_UPLOAD_LIBRARY_DOCUMENT`
>
> Upload a document to a Mistral AI library for use with RAG-enabled agents. Use this action to add documents to a library that can be accessed by Mistral AI agents. The uploaded document will be processed and indexed for retrieval-augmented generation. Prerequisites: - First obtain a valid library\_id using MISTRAL\_AI\_LIST\_LIBRARIES or MISTRAL\_AI\_CREATE\_LIBRARY. - Supported file formats include PDF, TXT, DOC, DOCX, and other common document types. - Maximum file size is 100 MB per document.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File to upload. Supported formats include PDF, TXT, DOC, DOCX, and other common document types.
>
> **library\_id** `string` *required*
>
> Unique identifier (UUID) of the library where the document will be uploaded. Use MISTRAL\_AI\_LIST\_LIBRARIES to get available library IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
