Arguments autorisés de l'API de complétion













Endpoints Beta Agents
(beta) API Agents












Exemples
Exemples réels de code
Lister les entités agents.
GET /v1/agents
Récupère une liste d'entités agents triées par date de création.
Playground
Testez les endpoints en direct
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.list({});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.list({});
console.log(result);
}
run();
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.list(page=0, page_size=20)
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.list(page=0, page_size=20)
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
[
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}
][
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}
]Créer un agent qui peut être utilisé dans une conversation.
POST /v1/agents
Créez un nouvel agent en lui donnant des instructions, des outils, une description. L'agent est ensuite disponible pour être utilisé comme assistant standard dans une conversation ou dans le cadre d'un pool d'agents à partir duquel il peut être utilisé.
description
guardrails
handoffs
instructions
Prompt d'instructions que le modèle suivra pendant la conversation.
metadata
model
name
Liste des outils disponibles pour le modèle pendant la conversation.
version_message
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Prompt d'instruction que le modèle suivra au cours de la conversation.
metadata
model
name
object
Valeur par défaut : "agent"
source
Liste des outils disponibles pour le modèle durant la conversation.
updated_at
version
version_message
versions
Playground
Testez les endpoints en direct
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.create({
model: "LeBaron",
name: "<value>",
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.create({
model: "LeBaron",
name: "<value>",
});
console.log(result);
}
run();
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.create(model="LeBaron", name="<value>", completion_args={
"response_format": {
"type": "text",
},
})
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.create(model="LeBaron", name="<value>", completion_args={
"response_format": {
"type": "text",
},
})
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"model": "ipsum eiusmod",
"name": "consequat do"
}'curl https://api.mistral.ai/v1/agents \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"model": "ipsum eiusmod",
"name": "consequat do"
}'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}Récupérer une entité agent.
GET /v1/agents/{agent_id}
Pour un agent donné, récupère une entité agent avec ses attributs. Le paramètre agent_version peut être un numéro de version entier ou un alias textuel.
agent_id
agent_version
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Prompt d'instruction que le modèle suivra pendant la conversation.
metadata
model
name
object
Valeur par défaut : "agent"
source
Liste des outils disponibles pour le modèle pendant la conversation.
updated_at
version
version_message
versions
Playground
Testez les endpoints en direct
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.get({
agentId: "<id>",
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.get({
agentId: "<id>",
});
console.log(result);
}
run();
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.get(agent_id="<id>")
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.get(agent_id="<id>")
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents/{agent_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}Supprimer une entité agent.
DELETE /v1/agents/{agent_id}
agent_id
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
mistral.beta.agents.delete(agent_id="<id>")
# Use the SDK ...
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
mistral.beta.agents.delete(agent_id="<id>")
# Use the SDK ...
curl https://api.mistral.ai/v1/agents/{agent_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/agents/{agent_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'Mettre à jour une entité agent.
PATCH /v1/agents/{agent_id}
Mettre à jour les attributs d'un agent et créer une nouvelle version.
agent_id
deployment_chat
description
guardrails
handoffs
instructions
Prompt d'instruction que le modèle suivra durant la conversation.
metadata
model
name
Liste des outils disponibles pour le modèle pendant la conversation.
version_message
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Prompt d'instructions que le modèle suivra durant la conversation.
metadata
model
name
object
Valeur par défaut : "agent"
source
Liste des outils disponibles pour le modèle pendant la conversation.
updated_at
version
version_message
versions
Playground
Testez les endpoints en direct
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.update({
agentId: "<id>",
agentUpdateRequest: {},
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.update({
agentId: "<id>",
agentUpdateRequest: {},
});
console.log(result);
}
run();
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.update(agent_id="<id>", completion_args={
"response_format": {
"type": "text",
},
})
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.update(agent_id="<id>", completion_args={
"response_format": {
"type": "text",
},
})
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'curl https://api.mistral.ai/v1/agents/{agent_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}Mettre à jour une version d'agent.
PATCH /v1/agents/{agent_id}/version
Changer la version d'un agent.
agent_id
version
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Prompt d'instruction que le modèle suivra durant la conversation.
metadata
model
name
object
Valeur par défaut : "agent"
source
Liste des outils disponibles pour le modèle pendant la conversation.
updated_at
version
version_message
versions
Playground
Testez les endpoints en direct
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.updateVersion({
agentId: "<id>",
version: 157995,
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.beta.agents.updateVersion({
agentId: "<id>",
version: 157995,
});
console.log(result);
}
run();
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.update_version(agent_id="<id>", version=157995)
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.update_version(agent_id="<id>", version=157995)
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/version \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/agents/{agent_id}/version \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}Lister toutes les versions d'un agent.
GET /v1/agents/{agent_id}/versions
Récupère toutes les versions d'un agent spécifique avec le contexte complet de l'agent. Prend en charge la pagination.
agent_id
page
Numéro de page (indexé à partir de 0)
page_size
Nombre de versions par page
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.list_versions(agent_id="<id>", page=0, page_size=20)
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.list_versions(agent_id="<id>", page=0, page_size=20)
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/versions \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents/{agent_id}/versions \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
[
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}
][
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}
]Récupérer une version spécifique d'un agent.
GET /v1/agents/{agent_id}/versions/{version}
Récupère une version spécifique d'un agent par numéro de version.
agent_id
version
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Prompt d'instruction que le modèle suivra pendant la conversation.
metadata
model
name
object
Valeur par défaut : "agent"
source
Liste des outils disponibles pour le modèle pendant la conversation.
updated_at
version
version_message
versions
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.get_version(agent_id="<id>", version="788393")
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.get_version(agent_id="<id>", version="788393")
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/versions/{version} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents/{agent_id}/versions/{version} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-10-07T20:56:01.974Z",
"deployment_chat": false,
"id": "ipsum eiusmod",
"model": "consequat do",
"name": "reprehenderit ut dolore",
"source": "occaecat dolor sit",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87,
"versions": [
14
]
}Liste tous les alias d'un agent.
GET /v1/agents/{agent_id}/aliases
Récupère tous les alias de version d'un agent spécifique.
agent_id
200
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.list_version_aliases(agent_id="<id>")
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.list_version_aliases(agent_id="<id>")
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
[
{
"alias": "ipsum eiusmod",
"created_at": "2025-10-07T20:56:01.974Z",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87
}
][
{
"alias": "ipsum eiusmod",
"created_at": "2025-10-07T20:56:01.974Z",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87
}
]Créer ou mettre à jour un alias de version d'agent.
PUT /v1/agents/{agent_id}/aliases
Créer un nouvel alias ou mettre à jour un alias existant pour qu'il pointe vers une version spécifique. Les alias sont uniques par agent et peuvent être réassignés à différentes versions.
agent_id
alias
version
200
Réponse réussie
alias
created_at
updated_at
version
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.create_version_alias(agent_id="<id>", alias="<value>", version=595141)
# Handle response
print(res)
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.create_version_alias(agent_id="<id>", alias="<value>", version=595141)
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X PUT \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X PUT \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"alias": "ipsum eiusmod",
"created_at": "2025-10-07T20:56:01.974Z",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87
}{
"alias": "ipsum eiusmod",
"created_at": "2025-10-07T20:56:01.974Z",
"updated_at": "2025-10-07T20:56:01.974Z",
"version": 87
}Supprimer un alias de version d'agent.
DELETE /v1/agents/{agent_id}/aliases
Supprimer un alias existant pour un agent.
agent_id
alias
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
mistral.beta.agents.delete_version_alias(agent_id="<id>", alias="<value>")
# Use the SDK ...
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
mistral.beta.agents.delete_version_alias(agent_id="<id>", alias="<value>")
# Use the SDK ...
curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'