# Mistral AI integration

> Mistral AI's La Plateforme API: chat, FIM and agent completions, embeddings, OCR, moderation, classification, audio, plus files, fine-tuning, batch, conversations, agents, and document libraries.

- Authentication: apiKey

## Tools (75)

- **Agents Completion**: Generate a completion using a pre-configured agent (deprecated agents completion API); like chat completion but driven by an agent_id instead of a model.
- **Append to Conversation**: Append new entries to an existing conversation and run them. Set `stream: true` for SSE.
- **Archive Fine-Tuned Model**: Archive a fine-tuned model, taking it out of active serving.
- **Cancel Batch Job**: Cancel a running batch inference job.
- **Cancel Fine-Tuning Job**: Cancel a running or queued fine-tuning job.
- **Chat Classifications**: Classify a conversation (list of chat messages) with a classifier model.
- **Chat Completion**: Generate a chat completion from a list of messages.
- **Chat Moderations**: Classify a conversation (list of chat messages) against moderation policy categories.
- **Classifications**: Classify raw text with a classifier model (including fine-tuned classifiers).
- **Create Agent**: Create an agent (model plus instructions, tools, and completion args) usable within conversations.
- **Create Batch Job**: Create a batch inference job over uploaded request files. Asynchronous: returns a job with a `status`; poll `GET /v1/batch/jobs/{job_id}` until terminal, then download the output file.
- **Create Conversation**: Create a conversation and run the first entries against a model or agent. Set `stream: true` for SSE. Persists server-side when `store` is true (default).
- **Create Embeddings**: Create embedding vectors for input text.
- **Create Fine-Tuning Job**: Create a fine-tuning job. Asynchronous: returns a job with a `status`; poll `GET /v1/fine_tuning/jobs/{job_id}` until it reaches a terminal state (e.g. `SUCCESS`, `FAILED`). If `auto_start` is false, start it with the start endpoint.
- **Create Library**: Create a new document library for retrieval-augmented generation. Beta.
- **Create or Update Agent Alias**: Create or update a named alias pointing at a specific agent version.
- **Create or Update Library Share**: Create or update an access level for a user, workspace, or organization on a library. Beta.
- **Create Transcription**: Transcribe an audio file to text. Provide the audio as an uploaded file, a file id, or a URL. Set `stream: true` for incremental SSE transcription.
- **Create Voice**: Create a custom voice from a base64-encoded audio sample.
- **Delete Agent**: Delete an agent entity.
- **Delete Agent Alias**: Delete an agent version alias.
- **Delete Conversation**: Delete a stored conversation.
- **Delete File**: Delete an uploaded file.
- **Delete Library**: Delete a library and all of its documents. Beta.
- **Delete Library Document**: Delete a document from a library. Beta.
- **Delete Library Share**: Remove an access grant from a library. Beta.
- **Delete Model**: Delete a fine-tuned model.
- **Delete Voice**: Delete a custom voice.
- **Download File Content**: Download the raw content of an uploaded file.
- **FIM Completion**: Fill-in-the-middle completion for code models (e.g. Codestral); completes between a prompt prefix and optional suffix.
- **Get Batch Job**: Retrieve a batch job's details and status. Poll this after Create Batch Job.
- **Get Conversation History**: Retrieve all entries in a conversation.
- **Get Conversation Messages**: Retrieve all messages in a conversation.
- **Get Document Extracted-Text Signed URL**: Retrieve a signed URL to download the extracted text of a document. Beta.
- **Get Document Signed URL**: Retrieve a signed URL to download the original document. Beta.
- **Get Document Status**: Retrieve the processing status of a specific document. Beta.
- **Get Document Text Content**: Retrieve the extracted text content of a specific document. Beta.
- **Get File Signed URL**: Get a temporary signed URL to download a file's content.
- **Get Fine-Tuning Job**: Retrieve a fine-tuning job's details and current status. Poll this after Create Fine-Tuning Job.
- **Get Library**: Retrieve detailed information about a specific library. Beta.
- **Get Library Document**: Retrieve the metadata of a specific document. Beta.
- **Get Voice**: Retrieve details of a single voice.
- **Get Voice Sample**: Retrieve the sample audio for a voice.
- **List Agent Aliases**: List all aliases defined for an agent.
- **List Agents**: List agent entities with optional filters and search.
- **List Agent Versions**: List all versions of an agent.
- **List Batch Jobs**: List batch inference jobs with optional filters.
- **List Conversations**: List stored conversations.
- **List Files**: List uploaded files.
- **List Fine-Tuning Jobs**: List fine-tuning jobs with optional filters.
- **List Libraries**: List all document libraries you have access to. Beta.
- **List Library Documents**: List documents in a given library. Beta.
- **List Library Shares**: List all access grants (shares) for a library. Beta.
- **List Models**: List all models available to the API key, including base and fine-tuned models.
- **List Voices**: List available text-to-speech voices (preset and custom).
- **Moderations**: Classify raw text against Mistral's moderation policy categories.
- **OCR**: Run optical character recognition on a document or image, returning extracted text and optional structured annotations.
- **Reprocess Document**: Reprocess a document (re-extract and re-index). Beta.
- **Restart Conversation**: Restart a conversation from a given entry, creating a new branch. Set `stream: true` for SSE.
- **Retrieve Agent**: Retrieve an agent entity, optionally at a specific version.
- **Retrieve Agent Version**: Retrieve a specific version of an agent.
- **Retrieve Conversation**: Retrieve a conversation's metadata.
- **Retrieve File**: Retrieve metadata for a single uploaded file.
- **Retrieve Model**: Retrieve details for a single model by id.
- **Start Fine-Tuning Job**: Start a validated fine-tuning job that was created without auto_start.
- **Text-to-Speech**: Generate speech audio from input text using a preset or custom voice. Returns audio bytes.
- **Unarchive Fine-Tuned Model**: Unarchive a previously archived fine-tuned model.
- **Update Agent**: Update an agent, creating a new version. Any omitted field is left unchanged.
- **Update Agent Version**: Switch the active version of an agent.
- **Update Fine-Tuned Model**: Update the name or description of a fine-tuned model.
- **Update Library**: Update a library's name or description. Beta.
- **Update Library Document**: Update a document's name or custom attributes without re-uploading. Beta.
- **Update Voice**: Update metadata of a custom voice.
- **Upload File**: Upload a file for use in fine-tuning, batch, or OCR. Max 512 MB; fine-tuning requires `.jsonl`.
- **Upload Library Document**: Upload a document to a library; it is processed and indexed for retrieval. Beta.

Connect Mistral AI in General Input: https://www.generalinput.com/apps/mistral-ai