La spec OpenAPI
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Agents bêta

API Agents (bêta)

Lister les entités d'agent.

GET /v1/agents

Récupérer une liste d'entités d'agent triées par date de création.

200

Response Type

Réponse réussie

Agent

{object}

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();
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'

200

[
  {
    "created_at": "2025-12-17T10:25:07.818693Z",
    "deployment_chat": false,
    "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
    "model": "mistral-small-latest",
    "name": "My resource",
    "source": "upload",
    "updated_at": "2025-12-17T10:41:03.469341Z",
    "version": 87,
    "versions": [
      14
    ]
  }
]

Créer un agent pouvant être utilisé au sein d'une conversation.

POST /v1/agents

Créer un nouvel agent en lui fournissant des instructions, des outils et une description. L'agent est ensuite disponible pour être utilisé comme assistant régulier dans une conversation ou en tant que partie d'un pool d'agents à partir duquel il peut être utilisé.

200

Réponse réussie

completion_args
CompletionArgs

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

created_at
*date-time
deployment_chat
*boolean
description
string|null
guardrails
array<GuardrailConfig>|null
handoffs
array<string>|null
id
*string
instructions
string|null

Instruction que le modèle suivra pendant la conversation.

metadata
map<any>|null
model
*string
name
*string
object
string

Default Value: "agent"

source
*string

Liste des outils disponibles pour le modèle durant la conversation.

updated_at
*date-time
version
*integer
version_message
string|null
versions
*array<integer>

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });

const agent = await client.beta.agents.create({
  model: "mistral-small-latest",
  name: "Support assistant",
});

console.log(agent.id);
import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

agent = client.beta.agents.create(
    model="mistral-small-latest",
    name="Support assistant",
)

print(agent.id)
curl https://api.mistral.ai/v1/agents \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "model": "mistral-small-latest",
  "name": "My Agent"
}'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "deployment_chat": false,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "model": "mistral-small-latest",
  "name": "My resource",
  "source": "upload",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "version": 87,
  "versions": [
    14
  ]
}

Récupérer une entité d'agent.

GET /v1/agents/{agent_id}

Étant donné un agent, récupérer une entité d'agent avec ses attributs. Le paramètre agent_version peut être un numéro de version entier ou un alias de chaîne de caractères.

200

Réponse réussie

completion_args
CompletionArgs

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

created_at
*date-time
deployment_chat
*boolean
description
string|null
guardrails
array<GuardrailConfig>|null
handoffs
array<string>|null
id
*string
instructions
string|null

Instruction que le modèle suivra pendant la conversation.

metadata
map<any>|null
model
*string
name
*string
object
string

Default Value: "agent"

source
*string

Liste des outils disponibles pour le modèle durant la conversation.

updated_at
*date-time
version
*integer
version_message
string|null
versions
*array<integer>

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();
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'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "deployment_chat": false,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "model": "mistral-small-latest",
  "name": "My resource",
  "source": "upload",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "version": 87,
  "versions": [
    14
  ]
}

Supprimer une entité d'agent.

DELETE /v1/agents/{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 ...

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é d'agent.

PATCH /v1/agents/{agent_id}

Mettre à jour les attributs d'un agent et créer une nouvelle version.

200

Réponse réussie

completion_args
CompletionArgs

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

created_at
*date-time
deployment_chat
*boolean
description
string|null
guardrails
array<GuardrailConfig>|null
handoffs
array<string>|null
id
*string
instructions
string|null

Instruction que le modèle suivra pendant la conversation.

metadata
map<any>|null
model
*string
name
*string
object
string

Default Value: "agent"

source
*string

Liste des outils disponibles pour le modèle durant la conversation.

updated_at
*date-time
version
*integer
version_message
string|null
versions
*array<integer>

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();
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 '{}'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "deployment_chat": false,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "model": "mistral-small-latest",
  "name": "My resource",
  "source": "upload",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "version": 87,
  "versions": [
    14
  ]
}

Mettre à jour une version d'agent.

PATCH /v1/agents/{agent_id}/version

Changer la version d'un agent.

200

Réponse réussie

completion_args
CompletionArgs

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

created_at
*date-time
deployment_chat
*boolean
description
string|null
guardrails
array<GuardrailConfig>|null
handoffs
array<string>|null
id
*string
instructions
string|null

Instruction que le modèle suivra pendant la conversation.

metadata
map<any>|null
model
*string
name
*string
object
string

Default Value: "agent"

source
*string

Liste des outils disponibles pour le modèle durant la conversation.

updated_at
*date-time
version
*integer
version_message
string|null
versions
*array<integer>

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();
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'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "deployment_chat": false,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "model": "mistral-small-latest",
  "name": "My resource",
  "source": "upload",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "version": 87,
  "versions": [
    14
  ]
}

Lister toutes les versions d'un agent.

GET /v1/agents/{agent_id}/versions

Récupérer toutes les versions pour un agent spécifique avec le contexte complet de l'agent. Prend en charge la pagination.

200

Response Type

Réponse réussie

Agent

{object}

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)

curl https://api.mistral.ai/v1/agents/{agent_id}/versions \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

[
  {
    "created_at": "2025-12-17T10:25:07.818693Z",
    "deployment_chat": false,
    "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
    "model": "mistral-small-latest",
    "name": "My resource",
    "source": "upload",
    "updated_at": "2025-12-17T10:41:03.469341Z",
    "version": 87,
    "versions": [
      14
    ]
  }
]

Récupérer une version spécifique d'un agent.

GET /v1/agents/{agent_id}/versions/{version}

Obtenir une version spécifique d'un agent par numéro de version.

200

Réponse réussie

completion_args
CompletionArgs

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

created_at
*date-time
deployment_chat
*boolean
description
string|null
guardrails
array<GuardrailConfig>|null
handoffs
array<string>|null
id
*string
instructions
string|null

Instruction que le modèle suivra pendant la conversation.

metadata
map<any>|null
model
*string
name
*string
object
string

Default Value: "agent"

source
*string

Liste des outils disponibles pour le modèle durant la conversation.

updated_at
*date-time
version
*integer
version_message
string|null
versions
*array<integer>

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)

curl https://api.mistral.ai/v1/agents/{agent_id}/versions/{version} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "deployment_chat": false,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "model": "mistral-small-latest",
  "name": "My resource",
  "source": "upload",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "version": 87,
  "versions": [
    14
  ]
}

Lister tous les alias d'un agent.

GET /v1/agents/{agent_id}/aliases

Récupérer tous les alias de version pour un agent spécifique.

200

Réponse réussie

AgentAliasResponse

{object}

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)

curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

[
  {
    "alias": "production",
    "created_at": "2025-12-17T10:25:07.818693Z",
    "updated_at": "2025-12-17T10:41:03.469341Z",
    "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 pointer vers une version spécifique. Les alias sont uniques par agent et peuvent être réaffectés à différentes versions.

200

Réponse réussie

alias
*string
created_at
*date-time
updated_at
*date-time
version
*integer

Playground

Testez les endpoints en direct

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

alias = client.beta.agents.create_version_alias(
    agent_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
    alias="production",
    version=1,
)

print(alias)
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": "production",
  "created_at": "2025-12-17T10:25:07.818693Z",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "version": 87
}

Supprimer un alias de version d'agent.

DELETE /v1/agents/{agent_id}/aliases

Supprimer un alias existant pour un agent.

Playground

Testez les endpoints en direct

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

client.beta.agents.delete_version_alias(
    agent_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
    alias="production",
)
curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'