Agents bêta

API Agents (bêta)

Lister les entités d'agent.

GET /v1/agents#

Récupérer une liste d'entités agent triées par date de création. Obsolète : certaines fonctionnalités, comme le partage d'agents, ne sont pas prises en charge par cet endpoint. Utilisez plutôt GET /v1/agents/pages avec pagination par curseur.

200

Response Type

array<Agent>

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

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

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

tools#

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 { 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)

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"
}'

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

{
  "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 les entités agent avec pagination par curseur

GET /v1/agents/pages#

Récupérer une page d'entités agent. Contrairement à l'endpoint obsolète GET /v1/agents, cet endpoint utilise une pagination par curseur opaque et respecte le partage par agent, en retournant uniquement les agents que l'appelant est autorisé à voir.

200

Réponse réussie

data#

*array<Agent>

Réponse réussie

next_page_token#

string|null

object#

string

Default Value: "list"

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/agents/pages \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/agents/pages \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "data": [
    {
      "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
      ]
    }
  ]
}

{
  "data": [
    {
      "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

tools#

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

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

{
  "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}#

Supprimer une entité agent.

Playground

Testez les endpoints en direct

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  await mistral.beta.agents.delete({
    agentId: "<id>",
  });


}

run();

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  await mistral.beta.agents.delete({
    agentId: "<id>",
  });


}

run();

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

tools#

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>",
    updateAgentRequest: {
      completionArgs: {
        responseFormat: {
          type: "text",
        },
      },
    },
  });

  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>",
    updateAgentRequest: {
      completionArgs: {
        responseFormat: {
          type: "text",
        },
      },
    },
  });

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

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

tools#

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

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

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

array<Agent>

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.listVersions({
    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.listVersions({
    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.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-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
    ]
  }
]

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

tools#

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.getVersion({
    agentId: "<id>",
    version: "<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.getVersion({
    agentId: "<id>",
    version: "<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.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-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
  ]
}

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

Response Type

array<AgentAliasResponse>

Réponse réussie

AgentAliasResponse#

{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.listVersionAliases({
    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.listVersionAliases({
    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.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": "production",
    "created_at": "2025-12-17T10:25:07.818693Z",
    "updated_at": "2025-12-17T10:41:03.469341Z",
    "version": 87
  }
]

[
  {
    "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 { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.agents.createVersionAlias({
    agentId: "<id>",
    alias: "<value>",
    version: 595141,
  });

  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.createVersionAlias({
    agentId: "<id>",
    alias: "<value>",
    version: 595141,
  });

  console.log(result);
}

run();

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)

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'

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
}

{
  "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 { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  await mistral.beta.agents.deleteVersionAlias({
    agentId: "<id>",
    alias: "<value>",
  });


}

run();

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  await mistral.beta.agents.deleteVersionAlias({
    agentId: "<id>",
    alias: "<value>",
  });


}

run();

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",
)

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'

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

Agents bêta

Exemples

GET /v1/agents#

Agent#

Playground

POST /v1/agents#

Request Body#

completion_args#

description#

guardrails#

handoffs#

instructions#

metadata#

model#

name#

tools#

version_message#

completion_args#

created_at#

deployment_chat#

description#

guardrails#

handoffs#

id#

instructions#

metadata#

model#

name#

object#

source#

tools#

updated_at#

version#

version_message#

versions#

Playground

GET /v1/agents/pages#

data#

next_page_token#

object#

Playground

GET /v1/agents/{agent_id}#

Parameters#

agent_id#

agent_version#

completion_args#

created_at#

deployment_chat#

description#

guardrails#

handoffs#

id#

instructions#

metadata#

model#

name#

object#

source#

tools#

updated_at#

version#

version_message#

versions#

Playground

DELETE /v1/agents/{agent_id}#

Parameters#

agent_id#

Playground

PATCH /v1/agents/{agent_id}#

Parameters#

agent_id#

Request Body#

completion_args#

deployment_chat#

description#

guardrails#

handoffs#

instructions#

metadata#

model#