# Mistral AI API API

> Mistral AI API API on Apizie: 170 endpoints (List Models, Retrieve Model, Delete Model, List all created conversations., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/ai:mistral/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ai:mistral`
- Category: Artificial Intelligence
- Status: byok
- Source: https://mistral
- Page: https://zieapi.vercel.app/api/ai/mistral
- OpenAPI: https://zieapi.vercel.app/api/ai/mistral/openapi.json

Our Chat Completion and Embeddings APIs specification. Create your account on [La Plateforme](https://console.mistral.ai) to get access and read the [docs](https://docs.mistral.ai) to learn how to use it.

## Endpoints

### List Models
`GET https://zieapi.vercel.app/v1/ai:mistral/list-models-v1-models-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| provider | string | no |  |
| model | string | no |  |

### Retrieve Model
`GET https://zieapi.vercel.app/v1/ai:mistral/retrieve-model-v1-models-model-id-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | yes | The ID of the model to retrieve. |

### Delete Model
`POST https://zieapi.vercel.app/v1/ai:mistral/delete-model-v1-models-model-id-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | yes | The ID of the model to delete. |

### List all created conversations.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no |  |
| page_size | integer | no |  |
| metadata | string | no |  |

### Create a conversation and append entries to it.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-start` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Retrieve a conversation information.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes | ID of the conversation from which we are fetching metadata. |

### Append new entries to an existing conversation.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-append` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes | ID of the conversation to which we append entries. |
| body | object | yes | JSON request body |

### Delete a conversation.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes | ID of the conversation from which we are fetching metadata. |

### Retrieve all entries in a conversation.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes | ID of the conversation from which we are fetching entries. |

### Retrieve all messages in a conversation.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-messages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes | ID of the conversation from which we are fetching messages. |

### Restart a conversation starting from a given entry.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-restart` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes | ID of the original conversation which is being restarted. |
| body | object | yes | JSON request body |

### Create a agent that can be used within a conversation.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Retrieve an agent entity.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |
| agent_version | string | no |  |

### Update an agent entity.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete an agent entity.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |

### List agent entities, cursor-paginated.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-list-pages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page_size | integer | no | Number of agents per page |
| deployment_chat | string | no |  |
| sources | string | no |  |
| name | string | no | Filter by agent name |
| search | string | no | Search agents by name or ID |
| id | string | no |  |
| metadata | string | no |  |
| page_token | string | no | Opaque cursor from a previous response's next_page_token. When set, results page forward from the cursor. |

### Update an agent version.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-update-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |
| version | integer | yes |  |

### List all versions of an agent.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-list-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |
| page | integer | no | Page number (0-indexed) |
| page_size | integer | no | Number of versions per page |

### Retrieve a specific version of an agent.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-get-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |
| version | string | yes |  |

### List all aliases for an agent.
`GET https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-list-version-aliases` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |

### Create or update an agent version alias.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-create-or-update-alias` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |
| alias | string | yes |  |
| version | integer | yes |  |

### Delete an agent version alias.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-agents-delete-alias` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | yes |  |
| alias | string | yes |  |

### Create a conversation and append entries to it.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-start-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Append new entries to an existing conversation.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-append-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes | ID of the conversation to which we append entries. |
| body | object | yes | JSON request body |

### Restart a conversation starting from a given entry.
`POST https://zieapi.vercel.app/v1/ai:mistral/agents-api-v1-conversations-restart-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes | ID of the original conversation which is being restarted. |
| body | object | yes | JSON request body |

### List Files
`GET https://zieapi.vercel.app/v1/ai:mistral/files-api-routes-list-files` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no |  |
| page_size | integer | no |  |
| include_total | boolean | no |  |
| sample_type | string | no |  |
| source | string | no |  |
| search | string | no |  |
| purpose | string | no |  |
| mimetypes | string | no |  |

### Upload File
`POST https://zieapi.vercel.app/v1/ai:mistral/files-api-routes-upload-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Retrieve File
`GET https://zieapi.vercel.app/v1/ai:mistral/files-api-routes-retrieve-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| file_id | string | yes |  |

### Delete File
`POST https://zieapi.vercel.app/v1/ai:mistral/files-api-routes-delete-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| file_id | string | yes |  |

### Download File
`GET https://zieapi.vercel.app/v1/ai:mistral/files-api-routes-download-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| file_id | string | yes |  |

### Get Signed Url
`GET https://zieapi.vercel.app/v1/ai:mistral/files-api-routes-get-signed-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| file_id | string | yes |  |
| expiry | integer | no | Number of hours before the url becomes invalid. Defaults to 24h |

### Get Fine Tuning Jobs
`GET https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-fine-tuning-get-fine-tuning-jobs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | The page number of the results to be returned. |
| page_size | integer | no | The number of items to return per page. |
| model | string | no | The model name used for fine-tuning to filter on. When set, the other results are not displayed. |
| created_after | string | no | The date/time to filter on. When set, the results for previous creation times are not displayed. |
| created_before | string | no |  |
| created_by_me | boolean | no | When set, only return results for jobs created by the API caller. Other results are not displayed. |
| status | string | no | The current job state to filter on. When set, the other results are not displayed. |
| wandb_project | string | no | The Weights and Biases project to filter on. When set, the other results are not displayed. |
| wandb_name | string | no | The Weight and Biases run name to filter on. When set, the other results are not displayed. |
| suffix | string | no | The model suffix to filter on. When set, the other results are not displayed. |

### Create Fine Tuning Job
`POST https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-fine-tuning-create-fine-tuning-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dry_run | string | no | * If `true` the job is not spawned, instead the query returns a handful of useful metadata for the user to perform sanity checks (see… |
| body | object | yes | JSON request body |

### Get Fine Tuning Job
`GET https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-fine-tuning-get-fine-tuning-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes | The ID of the job to analyse. |

### Cancel Fine Tuning Job
`POST https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-fine-tuning-cancel-fine-tuning-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes | The ID of the job to cancel. |

### Start Fine Tuning Job
`POST https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-fine-tuning-start-fine-tuning-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes |  |

### Update Fine Tuned Model
`POST https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-fine-tuning-update-fine-tuned-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | yes | The ID of the model to update. |
| body | object | yes | JSON request body |

### Archive Fine Tuned Model
`POST https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-fine-tuning-archive-fine-tuned-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | yes | The ID of the model to archive. |

### Unarchive Fine Tuned Model
`POST https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-fine-tuning-unarchive-fine-tuned-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | yes | The ID of the model to unarchive. |

### Get Batch Jobs
`GET https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-batch-get-batch-jobs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no |  |
| page_size | integer | no |  |
| model | string | no |  |
| agent_id | string | no |  |
| metadata | string | no |  |
| created_after | string | no |  |
| created_by_me | boolean | no |  |
| status | string | no |  |
| order_by | string | no |  |

### Create Batch Job
`POST https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-batch-create-batch-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Batch Job
`GET https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-batch-get-batch-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes |  |
| inline | string | no |  |

### Cancel Batch Job
`POST https://zieapi.vercel.app/v1/ai:mistral/jobs-api-routes-batch-cancel-batch-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes |  |

### Chat Completion
`POST https://zieapi.vercel.app/v1/ai:mistral/chat-completion-v1-chat-completions-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Fim Completion
`POST https://zieapi.vercel.app/v1/ai:mistral/fim-completion-v1-fim-completions-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Embeddings
`POST https://zieapi.vercel.app/v1/ai:mistral/embeddings-v1-embeddings-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Moderations
`POST https://zieapi.vercel.app/v1/ai:mistral/moderations-v1-moderations-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Chat Moderations
`POST https://zieapi.vercel.app/v1/ai:mistral/chat-moderations-v1-chat-moderations-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### OCR
`POST https://zieapi.vercel.app/v1/ai:mistral/ocr-v1-ocr-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Classifications
`POST https://zieapi.vercel.app/v1/ai:mistral/classifications-v1-classifications-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Chat Classifications
`POST https://zieapi.vercel.app/v1/ai:mistral/chat-classifications-v1-chat-classifications-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Create Transcription
`POST https://zieapi.vercel.app/v1/ai:mistral/audio-api-v1-transcriptions-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Create Streaming Transcription (SSE)
`POST https://zieapi.vercel.app/v1/ai:mistral/audio-api-v1-transcriptions-post-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Speech
`POST https://zieapi.vercel.app/v1/ai:mistral/speech-v1-audio-speech-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### List all voices
`GET https://zieapi.vercel.app/v1/ai:mistral/list-voices-v1-audio-voices-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | Maximum number of voices to return |
| offset | integer | no | Offset for pagination |

### Create a new voice
`POST https://zieapi.vercel.app/v1/ai:mistral/create-voice-v1-audio-voices-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get voice details
`GET https://zieapi.vercel.app/v1/ai:mistral/get-voice-v1-audio-voices-voice-id-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| voice_id | string | yes |  |

### Update voice metadata
`POST https://zieapi.vercel.app/v1/ai:mistral/update-voice-v1-audio-voices-voice-id-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| voice_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete a custom voice
`POST https://zieapi.vercel.app/v1/ai:mistral/delete-voice-v1-audio-voices-voice-id-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| voice_id | string | yes |  |

### Get voice sample audio
`GET https://zieapi.vercel.app/v1/ai:mistral/get-voice-sample-audio-v1-audio-voices-voice-id-sample-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| voice_id | string | yes |  |

### List all libraries you have access to.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-list-v1` (byok)

### Create a new Library.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-create-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Detailed information about a specific Library.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-get-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |

### Update a library.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-update-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete a library and all of it's document.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-delete-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |

### List documents in a given library.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-list-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| search | string | no |  |
| page_size | integer | no |  |
| page | integer | no |  |
| filters_attributes | string | no |  |
| sort_by | string | no |  |
| sort_order | string | no |  |

### Upload a new document.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-upload-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| body | object | yes | Form fields as a JSON object |

### Retrieve the metadata of a specific document.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-get-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| document_id | string | yes |  |

### Update the metadata of a specific document.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-update-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| document_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete a document.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-delete-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| document_id | string | yes |  |

### Retrieve the text content of a specific document.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-get-text-content-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| document_id | string | yes |  |

### Retrieve the processing status of a specific document.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-get-status-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| document_id | string | yes |  |

### Retrieve the signed URL of a specific document.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-get-signed-url-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| document_id | string | yes |  |

### Retrieve the signed URL of text extracted from a given document.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-get-extracted-text-signed-url-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| document_id | string | yes |  |

### Reprocess a document.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-documents-reprocess-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| document_id | string | yes |  |

### List all of the access to this library.
`GET https://zieapi.vercel.app/v1/ai:mistral/libraries-share-list-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |

### Create or update an access level.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-share-create-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete an access level.
`POST https://zieapi.vercel.app/v1/ai:mistral/libraries-share-delete-v1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library_id | string | yes |  |
| body | object | yes | JSON request body |

### Get Chat Completion Events
`POST https://zieapi.vercel.app/v1/ai:mistral/get-chat-completion-events-v1-observability-chat-completion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page_size | integer | no |  |
| cursor | string | no |  |
| body | object | yes | JSON request body |

### Alternative to /search that returns only the IDs and that can return many IDs at once
`POST https://zieapi.vercel.app/v1/ai:mistral/get-chat-completion-event-ids-v1-observability-chat-completi` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Chat Completion Event
`GET https://zieapi.vercel.app/v1/ai:mistral/get-chat-completion-event-v1-observability-chat-completion-e` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_id | string | yes |  |

### Get Similar Chat Completion Events
`GET https://zieapi.vercel.app/v1/ai:mistral/get-similar-chat-completion-events-v1-observability-chat-com` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_id | string | yes |  |

### Get Chat Completion Fields
`GET https://zieapi.vercel.app/v1/ai:mistral/get-chat-completion-fields-v1-observability-chat-completion` (byok)

### Get Chat Completion Field Options
`GET https://zieapi.vercel.app/v1/ai:mistral/get-chat-completion-field-options-v1-observability-chat-comp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| field_name | string | yes |  |
| operator | string | yes | The operator to use for filtering options |

### Get Chat Completion Field Options Counts
`POST https://zieapi.vercel.app/v1/ai:mistral/get-chat-completion-field-options-counts-v1-observability-ch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| field_name | string | yes |  |
| body | object | yes | JSON request body |

### Run Judge on an event based on the given options
`POST https://zieapi.vercel.app/v1/ai:mistral/judge-chat-completion-event-v1-observability-chat-completion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_id | string | yes |  |
| body | object | yes | JSON request body |

### Get judges with optional filtering and search
`GET https://zieapi.vercel.app/v1/ai:mistral/get-judges-v1-observability-judges-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| type_filter | string | no | Filter by judge output types |
| model_filter | string | no | Filter by model names |
| page_size | integer | no |  |
| page | integer | no |  |
| q | string | no |  |

### Create a new judge
`POST https://zieapi.vercel.app/v1/ai:mistral/create-judge-v1-observability-judges-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get judge by id
`GET https://zieapi.vercel.app/v1/ai:mistral/get-judge-by-id-v1-observability-judges-judge-id-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| judge_id | string | yes |  |

### Update a judge
`POST https://zieapi.vercel.app/v1/ai:mistral/update-judge-v1-observability-judges-judge-id-put` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| judge_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete a judge
`POST https://zieapi.vercel.app/v1/ai:mistral/delete-judge-v1-observability-judges-judge-id-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| judge_id | string | yes |  |

### Run a saved judge on a conversation
`POST https://zieapi.vercel.app/v1/ai:mistral/judge-conversation-v1-observability-judges-judge-id-live-jud` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| judge_id | string | yes |  |
| body | object | yes | JSON request body |

### Get all campaigns
`GET https://zieapi.vercel.app/v1/ai:mistral/get-campaigns-v1-observability-campaigns-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page_size | integer | no |  |
| page | integer | no |  |
| q | string | no |  |

### Create and start a new campaign
`POST https://zieapi.vercel.app/v1/ai:mistral/create-campaign-v1-observability-campaigns-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get campaign by id
`GET https://zieapi.vercel.app/v1/ai:mistral/get-campaign-by-id-v1-observability-campaigns-campaign-id-ge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes |  |

### Delete a campaign
`POST https://zieapi.vercel.app/v1/ai:mistral/delete-campaign-v1-observability-campaigns-campaign-id-delet` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes |  |

### Get campaign status by campaign id
`GET https://zieapi.vercel.app/v1/ai:mistral/get-campaign-status-by-id-v1-observability-campaigns-campaig` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes |  |

### Get event ids that were selected by the given campaign
`GET https://zieapi.vercel.app/v1/ai:mistral/get-campaign-selected-events-v1-observability-campaigns-camp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes |  |
| page_size | integer | no |  |
| page | integer | no |  |

### List existing datasets
`GET https://zieapi.vercel.app/v1/ai:mistral/get-datasets-v1-observability-datasets-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page_size | integer | no |  |
| page | integer | no |  |
| q | string | no |  |

### Create a new empty dataset
`POST https://zieapi.vercel.app/v1/ai:mistral/create-dataset-v1-observability-datasets-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get dataset by id
`GET https://zieapi.vercel.app/v1/ai:mistral/get-dataset-by-id-v1-observability-datasets-dataset-id-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |

### Patch dataset
`POST https://zieapi.vercel.app/v1/ai:mistral/update-dataset-v1-observability-datasets-dataset-id-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete a dataset
`POST https://zieapi.vercel.app/v1/ai:mistral/delete-dataset-v1-observability-datasets-dataset-id-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |

### List existing records in the dataset
`GET https://zieapi.vercel.app/v1/ai:mistral/get-dataset-records-v1-observability-datasets-dataset-id-rec` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| page_size | integer | no |  |
| page | integer | no |  |

### Add a conversation to the dataset
`POST https://zieapi.vercel.app/v1/ai:mistral/create-dataset-record-v1-observability-datasets-dataset-id-r` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| body | object | yes | JSON request body |

### Populate the dataset with a campaign
`POST https://zieapi.vercel.app/v1/ai:mistral/post-dataset-records-from-campaign-v1-observability-datasets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| body | object | yes | JSON request body |

### Populate the dataset with samples from the explorer
`POST https://zieapi.vercel.app/v1/ai:mistral/post-dataset-records-from-explorer-v1-observability-datasets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| body | object | yes | JSON request body |

### Populate the dataset with samples from an uploaded file
`POST https://zieapi.vercel.app/v1/ai:mistral/post-dataset-records-from-file-v1-observability-datasets-dat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| body | object | yes | JSON request body |

### Populate the dataset with samples from the playground
`POST https://zieapi.vercel.app/v1/ai:mistral/post-dataset-records-from-playground-v1-observability-datase` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| body | object | yes | JSON request body |

### Populate the dataset with samples from another dataset
`POST https://zieapi.vercel.app/v1/ai:mistral/post-dataset-records-from-dataset-v1-observability-datasets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| body | object | yes | JSON request body |

### Export to the Files API and retrieve presigned URL to download the resulting JSONL file
`GET https://zieapi.vercel.app/v1/ai:mistral/export-dataset-to-jsonl-v1-observability-datasets-dataset-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |

### Get status of a dataset import task
`GET https://zieapi.vercel.app/v1/ai:mistral/get-dataset-import-task-v1-observability-datasets-dataset-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| task_id | string | yes |  |

### List import tasks for the given dataset
`GET https://zieapi.vercel.app/v1/ai:mistral/get-dataset-import-tasks-v1-observability-datasets-dataset-i` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_id | string | yes |  |
| page_size | integer | no |  |
| page | integer | no |  |

### Get the content of a given conversation from a dataset
`GET https://zieapi.vercel.app/v1/ai:mistral/get-dataset-record-v1-observability-dataset-records-dataset` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_record_id | string | yes |  |

### Delete a record from a dataset
`POST https://zieapi.vercel.app/v1/ai:mistral/delete-dataset-record-v1-observability-dataset-records-datas` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_record_id | string | yes |  |

### Delete multiple records from datasets
`POST https://zieapi.vercel.app/v1/ai:mistral/delete-dataset-records-v1-observability-dataset-records-bulk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Run Judge on a dataset record based on the given options
`POST https://zieapi.vercel.app/v1/ai:mistral/judge-dataset-record-v1-observability-dataset-records-datase` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_record_id | string | yes |  |
| body | object | yes | JSON request body |

### Update a dataset record conversation payload
`POST https://zieapi.vercel.app/v1/ai:mistral/update-dataset-record-payload-v1-observability-dataset-recor` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_record_id | string | yes |  |
| body | object | yes | JSON request body |

### Update conversation properties
`POST https://zieapi.vercel.app/v1/ai:mistral/update-dataset-record-properties-v1-observability-dataset-re` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataset_record_id | string | yes |  |
| body | object | yes | JSON request body |

### Get Workflow Execution
`GET https://zieapi.vercel.app/v1/ai:mistral/get-workflow-execution-v1-workflows-executions-execution-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| execution_id | string | yes |  |

…and 50 more. See the OpenAPI spec.

## Example
```
curl "https://zieapi.vercel.app/v1/ai:mistral/list-models-v1-models-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Mistral AI API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/ai:mistral/list-models-v1-models-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Mistral AI API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Mistral AI API itself also needs your own key from mistral.

### Can AI agents use the Mistral AI API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ai:mistral.

### What is the status of the Mistral AI API API?
Needs your own provider key (bring your own key)