Numéro de page à retourner.
Utilisateurs Admin Bêta
(Beta) API Admin - gestion des utilisateurs. Requiert une clé API admin.
Exemples
Exemples réels de code
Récupérer 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 d'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"
]
}Récupérer les invitations
GET /v1/admin/users-invite#
Lister les invitations en attente pour l'organisation.
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 dans l'organisation.
AdminApiKey#
Adresse e-mail, e-mails séparés par des virgules ou e-mails séparés par des sauts de ligne à inviter.
email_language#
Langue utilisée pour les e-mails d'invitation.
role#
Valeur de rôle unique obsolète, conservée pour la rétrocompatibilité. Exclusif avec 'role_name'.
role_name#
Nom de rôle unique obsolète, conservé pour la rétrocompatibilité. Exclusif avec 'role'.
role_names#
Noms de rôles simplifiés à attribuer. Exclusif avec 'roles'.
roles#
Valeurs de rôles à attribuer. Exclusif avec 'role_names'.
subscription_seat_automatic_granting#
Default Value: false
Indique si les siège d’abonnement doivent être attribués automatiquement.
subscription_type#
Siège de produit unique obsolète à attribuer.
subscription_types#
Sièges de produits à attribuer à l’utilisateur.
workspace_uuids#
ID des espaces de travail que les utilisateurs invités doivent rejoindre.
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 une Invitation
DELETE /v1/admin/users-invite/{invite_uuid}#
Supprimer une Invitation
AdminApiKey#
ID de l'Invitation de 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"
}Récupérer un utilisateur
GET /v1/admin/users/{user_id}#
Récupérer les détails d'un membre de l'organisation.
AdminApiKey#
ID de l'utilisateur.
200
OK
is_sso_outsider#
Indique si le membre est hors du domaine SSO.
Identifiant du fournisseur d'identité pour le membre.
raw_role#
Rôle d'organisation unique obsolète. Utilisez « raw_roles » à la place.
raw_roles#
Rôles d'organisation attribués au membre.
subscription_types#
Sièges produits 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 un 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 un utilisateur
PATCH /v1/admin/users/{user_id}#
Mettre à jour les rôles et les sièges produit d'un membre de l'organisation.
AdminApiKey#
ID de l'utilisateur.
role#
Valeur de rôle unique obsolète, conservée pour la rétrocompatibilité. Mutuellement exclusif avec « role_name ».
role_name#
Nom de rôle unique obsolète, conservé pour la rétrocompatibilité. 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 produits à attribuer au membre.
200
OK
is_sso_outsider#
Indique si le membre est hors du domaine SSO.
Identifiant du fournisseur d'identité pour le membre.
raw_role#
Rôle d'organisation unique obsolète. Utilisez « raw_roles » à la place.
raw_roles#
Rôles d'organisation attribués au membre.
subscription_types#
Sièges produits 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"
}Récupérer les rôles
GET /v1/admin/roles#
Lister les rôles de l'organisation et des espaces 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": null
}
],
"workspace_roles": [
{
"description": "Can manage workspace members and settings",
"is_custom_role": false,
"name": "workspace_admin",
"uuid": null
}
]
}{
"organization_roles": [
{
"description": "Can manage workspace members and settings",
"is_custom_role": false,
"name": "workspace_admin",
"uuid": null
}
],
"workspace_roles": [
{
"description": "Can manage workspace members and settings",
"is_custom_role": false,
"name": "workspace_admin",
"uuid": null
}
]
}