Numéro de page à retourner.
Utilisateurs Admin Bêta
(beta) API Admin - gérer les utilisateurs. Nécessite une clé API admin.
Exemples
Exemples réels de code
Obtenir les utilisateurs
GET /v1/admin/users#
Lister les membres de l'Organisation et les invitations en attente.
AdminApiKey#
200
OK
Nombre total d'utilisateurs et d'invitations correspondant à la requête.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/users \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/admin/users \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"invites": [
{
"created_at": "2025-12-17T10:25:07.818693Z",
"email": "alice.martin@example.com",
"expired": false,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}
],
"members": [
{
"created_at": "2025-12-17T10:25:07.818693Z",
"email": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}
],
"page": null,
"page_size": null,
"total": null
}{
"invites": [
{
"created_at": "2025-12-17T10:25:07.818693Z",
"email": "alice.martin@example.com",
"expired": false,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}
],
"members": [
{
"created_at": "2025-12-17T10:25:07.818693Z",
"email": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}
],
"page": null,
"page_size": null,
"total": null
}Créer des utilisateurs
POST /v1/admin/users#
Créer des membres de l'Organisation.
AdminApiKey#
OrganizationMemberCreate#
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/users \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '[
{
"email": "alice.martin@example.com",
"first_name": "Alice",
"last_name": "Martin"
}
]'curl https://api.mistral.ai/v1/admin/users \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '[
{
"email": "alice.martin@example.com",
"first_name": "Alice",
"last_name": "Martin"
}
]'200
{
"email_to_user_id": [
"ipsum eiusmod"
],
"invalid_emails": [
"consequat do"
]
}{
"email_to_user_id": [
"ipsum eiusmod"
],
"invalid_emails": [
"consequat do"
]
}Obtenir une invitation
GET /v1/admin/users-invite#
Lister les invitations en attente à l'Organization.
AdminApiKey#
200
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/users-invite \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/admin/users-invite \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
[
{
"email": null,
"invite_uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"role": "A",
"roles": [
"A"
]
}
][
{
"email": null,
"invite_uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"role": "A",
"roles": [
"A"
]
}
]Inviter des utilisateurs
POST /v1/admin/users-invite#
Inviter des utilisateurs à l'Organization.
AdminApiKey#
email_language#
Langue utilisée pour les e-mails d'invitation.
role#
Valeur de rôle unique héritée obsolète, conservée pour la compatibilité ascendante. Mutuellement exclusive avec 'role_name'.
role_name#
Nom de rôle unique obsolète, conservé pour la compatibilité ascendante. Mutuellement exclusif avec 'role'.
role_names#
Noms de rôles simplifiés à attribuer. Mutuellement exclusif avec 'roles'.
roles#
Valeurs de rôles à attribuer. Mutuellement exclusif avec 'role_names'.
subscription_seat_automatic_granting#
Valeur par défaut: false
Indique s'il faut attribuer automatiquement des sièges d'abonnement.
subscription_type#
Siège de produit unique obsolète à attribuer.
subscription_types#
Sièges de produit à attribuer à l'utilisateur.
workspace_uuids#
ID des espaces de travail auxquels les utilisateurs invités doivent se joindre.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/users-invite \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"email": "alice.martin@example.com, bob.smith@example.com"
}'curl https://api.mistral.ai/v1/admin/users-invite \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"email": "alice.martin@example.com, bob.smith@example.com"
}'200
{
"already_members": [
"ipsum eiusmod"
],
"invalid_emails": [
"consequat do"
]
}{
"already_members": [
"ipsum eiusmod"
],
"invalid_emails": [
"consequat do"
]
}Supprimer l'invitation
DELETE /v1/admin/users-invite/{invite_uuid}#
Supprimer l'invitation
AdminApiKey#
ID d'invitation à l'Organisation.
200
OK
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/users-invite/{invite_uuid} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/admin/users-invite/{invite_uuid} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"message": "Organization member deleted successfully"
}{
"message": "Organization member deleted successfully"
}Obtenir l'utilisateur
GET /v1/admin/users/{user_id}#
Obtenir les détails d'un membre de l'Organisation.
AdminApiKey#
ID de l'utilisateur.
200
OK
is_sso_outsider#
Indique si le membre est en dehors du domaine SSO.
ID du fournisseur d'identité pour le membre.
raw_role#
Rôle unique d'organisation obsolète. Utilisez 'raw_roles' à la place.
raw_roles#
Rôles d'organisation attribués au membre.
subscription_types#
Sièges de produit attribués au membre.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/users/{user_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/admin/users/{user_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"created_at": "2025-12-17T10:25:07.818693Z",
"email": null,
"first_name": null,
"last_name": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}{
"created_at": "2025-12-17T10:25:07.818693Z",
"email": null,
"first_name": null,
"last_name": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}Supprimer l'utilisateur
DELETE /v1/admin/users/{user_id}#
Retirer un membre de l'Organisation.
AdminApiKey#
ID de l'utilisateur.
200
OK
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/users/{user_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/admin/users/{user_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"message": "Organization member deleted successfully"
}{
"message": "Organization member deleted successfully"
}Mettre à jour l'utilisateur
PATCH /v1/admin/users/{user_id}#
Mettre à jour les rôles et les sièges de produit d'un membre de l'Organisation.
AdminApiKey#
ID de l'utilisateur.
role#
Valeur de rôle unique héritée obsolète, conservée pour la compatibilité ascendante. Mutuellement exclusive avec 'role_name'.
role_name#
Nom de rôle unique obsolète, conservé pour la compatibilité ascendante. Mutuellement exclusif avec 'role'.
role_names#
Noms de rôles simplifiés à attribuer. Mutuellement exclusif avec 'roles'.
roles#
Valeurs de rôles à attribuer. Mutuellement exclusif avec 'role_names'.
subscription_types#
Sièges de produit à attribuer au membre.
200
OK
is_sso_outsider#
Indique si le membre est en dehors du domaine SSO.
ID du fournisseur d'identité pour le membre.
raw_role#
Rôle unique d'organisation obsolète. Utilisez 'raw_roles' à la place.
raw_roles#
Rôles d'organisation attribués au membre.
subscription_types#
Sièges de produit attribués au membre.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/users/{user_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'curl https://api.mistral.ai/v1/admin/users/{user_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'200
{
"created_at": "2025-12-17T10:25:07.818693Z",
"email": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}{
"created_at": "2025-12-17T10:25:07.818693Z",
"email": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}Obtenir les rôles
GET /v1/admin/roles#
Lister les rôles de l'Organization et de l'espace de travail.
AdminApiKey#
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/v1/admin/roles \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/admin/roles \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"organization_roles": [
{
"description": "Can manage workspace members and settings",
"is_custom_role": false,
"name": "workspace_admin",
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}
],
"workspace_roles": [
{
"description": "Can manage workspace members and settings",
"is_custom_role": false,
"name": "workspace_admin",
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}
]
}{
"organization_roles": [
{
"description": "Can manage workspace members and settings",
"is_custom_role": false,
"name": "workspace_admin",
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}
],
"workspace_roles": [
{
"description": "Can manage workspace members and settings",
"is_custom_role": false,
"name": "workspace_admin",
"uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}
]
}