mistral-ai-api

name	mistral-ai-api
description	Mistral AI API skill. Use when working with Mistral AI for models, conversations, agents. Covers 71 endpoints.
version	1.0.0
generator	lapsh

Mistral AI API

API version: 1.0.0

Auth

Bearer bearer

Base URL

https://api.mistral.ai

Setup

1. Set Authorization header with your Bearer token
2. GET /v1/models -- verify access
3. POST /v1/conversations -- create first conversations

Endpoints

71 endpoints across 15 groups. See references/api-spec.lap for full details.

models

Method	Path	Description
GET	/v1/models	List Models
GET	/v1/models/{model_id}	Retrieve Model
DELETE	/v1/models/{model_id}	Delete Model

conversations

Method	Path	Description
POST	/v1/conversations	Create a conversation and append entries to it.
GET	/v1/conversations	List all created conversations.
GET	/v1/conversations/{conversation_id}	Retrieve a conversation information.
DELETE	/v1/conversations/{conversation_id}	Delete a conversation.
POST	/v1/conversations/{conversation_id}	Append new entries to an existing conversation.
GET	/v1/conversations/{conversation_id}/history	Retrieve all entries in a conversation.
GET	/v1/conversations/{conversation_id}/messages	Retrieve all messages in a conversation.
POST	/v1/conversations/{conversation_id}/restart	Restart a conversation starting from a given entry.
POST	/v1/conversations/{conversation_id}#stream	Append new entries to an existing conversation.
POST	/v1/conversations/{conversation_id}/restart#stream	Restart a conversation starting from a given entry.

agents

Method	Path	Description
POST	/v1/agents	Create a agent that can be used within a conversation.
GET	/v1/agents	List agent entities.
GET	/v1/agents/{agent_id}	Retrieve an agent entity.
PATCH	/v1/agents/{agent_id}	Update an agent entity.
DELETE	/v1/agents/{agent_id}	Delete an agent entity.
PATCH	/v1/agents/{agent_id}/version	Update an agent version.
GET	/v1/agents/{agent_id}/versions	List all versions of an agent.
GET	/v1/agents/{agent_id}/versions/{version}	Retrieve a specific version of an agent.
PUT	/v1/agents/{agent_id}/aliases	Create or update an agent version alias.
GET	/v1/agents/{agent_id}/aliases	List all aliases for an agent.
POST	/v1/agents/completions	Agents Completion

conversations#stream

Method	Path	Description
POST	/v1/conversations#stream	Create a conversation and append entries to it.

files

Method	Path	Description
POST	/v1/files	Upload File
GET	/v1/files	List Files
GET	/v1/files/{file_id}	Retrieve File
DELETE	/v1/files/{file_id}	Delete File
GET	/v1/files/{file_id}/content	Download File
GET	/v1/files/{file_id}/url	Get Signed Url

fine_tuning

Method	Path	Description
GET	/v1/fine_tuning/jobs	Get Fine Tuning Jobs
POST	/v1/fine_tuning/jobs	Create Fine Tuning Job
GET	/v1/fine_tuning/jobs/{job_id}	Get Fine Tuning Job
POST	/v1/fine_tuning/jobs/{job_id}/cancel	Cancel Fine Tuning Job
POST	/v1/fine_tuning/jobs/{job_id}/start	Start Fine Tuning Job
PATCH	/v1/fine_tuning/models/{model_id}	Update Fine Tuned Model
POST	/v1/fine_tuning/models/{model_id}/archive	Archive Fine Tuned Model
DELETE	/v1/fine_tuning/models/{model_id}/archive	Unarchive Fine Tuned Model

batch

Method	Path	Description
GET	/v1/batch/jobs	Get Batch Jobs
POST	/v1/batch/jobs	Create Batch Job
GET	/v1/batch/jobs/{job_id}	Get Batch Job
POST	/v1/batch/jobs/{job_id}/cancel	Cancel Batch Job

chat

Method	Path	Description
POST	/v1/chat/completions	Chat Completion
POST	/v1/chat/moderations	Chat Moderations
POST	/v1/chat/classifications	Chat Classifications

fim

Method	Path	Description
POST	/v1/fim/completions	Fim Completion

embeddings

Method	Path	Description
POST	/v1/embeddings	Embeddings

moderations

Method	Path	Description
POST	/v1/moderations	Moderations

ocr

Method	Path	Description
POST	/v1/ocr	OCR

classifications

Method	Path	Description
POST	/v1/classifications	Classifications

audio

Method	Path	Description
POST	/v1/audio/transcriptions	Create Transcription
POST	/v1/audio/transcriptions#stream	Create Streaming Transcription (SSE)

libraries

Method	Path	Description
GET	/v1/libraries	List all libraries you have access to.
POST	/v1/libraries	Create a new Library.
GET	/v1/libraries/{library_id}	Detailed information about a specific Library.
DELETE	/v1/libraries/{library_id}	Delete a library and all of it's document.
PUT	/v1/libraries/{library_id}	Update a library.
GET	/v1/libraries/{library_id}/documents	List documents in a given library.
POST	/v1/libraries/{library_id}/documents	Upload a new document.
GET	/v1/libraries/{library_id}/documents/{document_id}	Retrieve the metadata of a specific document.
PUT	/v1/libraries/{library_id}/documents/{document_id}	Update the metadata of a specific document.
DELETE	/v1/libraries/{library_id}/documents/{document_id}	Delete a document.
GET	/v1/libraries/{library_id}/documents/{document_id}/text_content	Retrieve the text content of a specific document.
GET	/v1/libraries/{library_id}/documents/{document_id}/status	Retrieve the processing status of a specific document.
GET	/v1/libraries/{library_id}/documents/{document_id}/signed-url	Retrieve the signed URL of a specific document.
GET	/v1/libraries/{library_id}/documents/{document_id}/extracted-text-signed-url	Retrieve the signed URL of text extracted from a given document.
POST	/v1/libraries/{library_id}/documents/{document_id}/reprocess	Reprocess a document.
GET	/v1/libraries/{library_id}/share	List all of the access to this library.
PUT	/v1/libraries/{library_id}/share	Create or update an access level.
DELETE	/v1/libraries/{library_id}/share	Delete an access level.

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "List all models?" -> GET /v1/models
• "Get model details?" -> GET /v1/models/{model_id}
• "Delete a model?" -> DELETE /v1/models/{model_id}
• "Create a conversation?" -> POST /v1/conversations
• "List all conversations?" -> GET /v1/conversations
• "Get conversation details?" -> GET /v1/conversations/{conversation_id}
• "Delete a conversation?" -> DELETE /v1/conversations/{conversation_id}
• "List all history?" -> GET /v1/conversations/{conversation_id}/history
• "List all messages?" -> GET /v1/conversations/{conversation_id}/messages
• "Create a restart?" -> POST /v1/conversations/{conversation_id}/restart
• "Create a agent?" -> POST /v1/agents
• "List all agents?" -> GET /v1/agents
• "Get agent details?" -> GET /v1/agents/{agent_id}
• "Partially update a agent?" -> PATCH /v1/agents/{agent_id}
• "Delete a agent?" -> DELETE /v1/agents/{agent_id}
• "List all versions?" -> GET /v1/agents/{agent_id}/versions
• "Get version details?" -> GET /v1/agents/{agent_id}/versions/{version}
• "List all aliases?" -> GET /v1/agents/{agent_id}/aliases
• "Create a conversations#stream?" -> POST /v1/conversations#stream
• "Create a restart#stream?" -> POST /v1/conversations/{conversation_id}/restart#stream
• "Create a file?" -> POST /v1/files
• "Search files?" -> GET /v1/files
• "Get file details?" -> GET /v1/files/{file_id}
• "Delete a file?" -> DELETE /v1/files/{file_id}
• "List all content?" -> GET /v1/files/{file_id}/content
• "List all url?" -> GET /v1/files/{file_id}/url
• "List all jobs?" -> GET /v1/fine_tuning/jobs
• "Create a job?" -> POST /v1/fine_tuning/jobs
• "Get job details?" -> GET /v1/fine_tuning/jobs/{job_id}
• "Create a cancel?" -> POST /v1/fine_tuning/jobs/{job_id}/cancel
• "Create a start?" -> POST /v1/fine_tuning/jobs/{job_id}/start
• "Partially update a model?" -> PATCH /v1/fine_tuning/models/{model_id}
• "Create a archive?" -> POST /v1/fine_tuning/models/{model_id}/archive
• "List all jobs?" -> GET /v1/batch/jobs
• "Create a job?" -> POST /v1/batch/jobs
• "Get job details?" -> GET /v1/batch/jobs/{job_id}
• "Create a cancel?" -> POST /v1/batch/jobs/{job_id}/cancel
• "Create a completion?" -> POST /v1/chat/completions
• "Create a completion?" -> POST /v1/fim/completions
• "Create a completion?" -> POST /v1/agents/completions
• "Create a embedding?" -> POST /v1/embeddings
• "Create a moderation?" -> POST /v1/moderations

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP