Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Endpoints Beta Agents

(beta) API Agents

Lister les entités agents.

GET /v1/agents

Récupère une liste d'entités agents 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-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é.

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

Prompt d'instruction que le modèle suivra au cours de la conversation.

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

Valeur par défaut : "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.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)

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
  ]
}

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.

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

Prompt d'instruction que le modèle suivra pendant la conversation.

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

Valeur par défaut : "agent"

source
*string

Liste des outils disponibles pour le modèle pendant 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-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}

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é 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

Prompt d'instructions que le modèle suivra durant la conversation.

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

Valeur par défaut : "agent"

source
*string

Liste des outils disponibles pour le modèle pendant 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-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.

200

Réponse réussie

completion_args
CompletionArgs

Arguments autorisés de l'API de completion

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

Prompt d'instruction que le modèle suivra durant la conversation.

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

Valeur par défaut : "agent"

source
*string

Liste des outils disponibles pour le modèle pendant 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-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.

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-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.

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

Prompt d'instruction que le modèle suivra pendant la conversation.

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

Valeur par défaut : "agent"

source
*string

Liste des outils disponibles pour le modèle pendant 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-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.

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": "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.

200

Réponse réussie

alias
*string
created_at
*date-time
updated_at
*date-time
version
*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.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'

200

{
  "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.

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 ...

curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'