Numéro de la page à retourner.
Endpoints Beta Admin Users
Gérer les utilisateurs, les invitations et les rôles de l'organisation.
Exemples
Exemples réels de code
Récupérer les utilisateurs
GET /api/admin/users
Lister les membres de l'organisation et les invitations en attente.
AdminApiKey
page
page_size
Nombre maximal de résultats par page.
Adresse e-mail pour filtrer les utilisateurs et les invitations.
200
OK
page
Numéro de page retourné.
page_size
Nombre maximal de résultats par page.
total
Nombre total d'utilisateurs et d'invitations correspondant à la demande.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/users \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/api/admin/users \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"invites": [
{
"created_at": "2025-10-07T20:56:01.974Z",
"email": "ipsum eiusmod",
"expired": false,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "consequat do"
}
],
"members": [
{
"email": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "reprehenderit ut dolore"
}
],
"page": null,
"page_size": null,
"total": null
}{
"invites": [
{
"created_at": "2025-10-07T20:56:01.974Z",
"email": "ipsum eiusmod",
"expired": false,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "consequat do"
}
],
"members": [
{
"email": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "reprehenderit ut dolore"
}
],
"page": null,
"page_size": null,
"total": null
}Créer des utilisateurs
POST /api/admin/users
Créer des membres de l'organisation.
AdminApiKey
OrganizationMemberCreate
200
OK
email_to_user_id
Mappage de l'adresse e-mail de l'utilisateur créé vers son identifiant.
invalid_emails
Adresses e-mail n'ayant pas pu être créées.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/users \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '[
{
"email": "ipsum eiusmod",
"first_name": "consequat do",
"last_name": "reprehenderit ut dolore"
}
]'curl https://api.mistral.ai/api/admin/users \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '[
{
"email": "ipsum eiusmod",
"first_name": "consequat do",
"last_name": "reprehenderit ut dolore"
}
]'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 /api/admin/users-invite
Liste les invitations en attente de l’Organisation.
AdminApiKey
200
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/users-invite \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/api/admin/users-invite \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
[
{
"email": null,
"invite_uuid": "ipsum eiusmod",
"role": "A",
"roles": [
"A"
]
}
][
{
"email": null,
"invite_uuid": "ipsum eiusmod",
"role": "A",
"roles": [
"A"
]
}
]Inviter des utilisateurs
POST /api/admin/users-invite
Invitez des utilisateurs à rejoindre l’Organisation.
AdminApiKey
Adresse e-mail, ou liste d’e-mails séparés par des virgules ou 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ôle à attribuer. Exclusif avec 'role_names'.
subscription_seat_automatic_granting
Valeur par défaut : false
Indique si les sièges d’abonnement doivent être attribués automatiquement.
subscription_type
Siège produit unique obsolète à attribuer.
subscription_types
Sièges produits à attribuer à l’utilisateur.
workspace_uuids
ID des espaces de travail que les utilisateurs invités doivent rejoindre.
200
OK
already_members
Adresses e-mail déjà membres de l’Organisation.
invalid_emails
Adresses e-mail qui n’ont pas pu être invitées.
invited_members_count
Nombre d’invitations créées avec succès.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/users-invite \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"email": "ipsum eiusmod"
}'curl https://api.mistral.ai/api/admin/users-invite \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"email": "ipsum eiusmod"
}'200
{
"already_members": [
"ipsum eiusmod"
],
"invalid_emails": [
"consequat do"
]
}{
"already_members": [
"ipsum eiusmod"
],
"invalid_emails": [
"consequat do"
]
}Supprimer une Invitation
DELETE /api/admin/users-invite/{invite_uuid}
Révoque une invitation en attente de l’Organisation.
AdminApiKey
invite_uuid
ID de l’invitation de l’Organisation.
200
OK
message
Message de résultat de suppression.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/users-invite/{invite_uuid} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/api/admin/users-invite/{invite_uuid} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"message": "ipsum eiusmod"
}{
"message": "ipsum eiusmod"
}Obtenir un utilisateur
GET /api/admin/users/{user_id}
Obtenez les détails d’un Membre de l’Organisation.
AdminApiKey
user_id
ID de l’utilisateur.
200
OK
Adresse e-mail de l’utilisateur.
first_name
Prénom de l’utilisateur.
last_name
Nom de famille de l’utilisateur.
uuid
ID de l’utilisateur.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/users/{user_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/api/admin/users/{user_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"email": null,
"first_name": null,
"last_name": null,
"uuid": "ipsum eiusmod"
}{
"email": null,
"first_name": null,
"last_name": null,
"uuid": "ipsum eiusmod"
}Supprimer un utilisateur
DELETE /api/admin/users/{user_id}
Retirez un Membre de l’Organisation.
AdminApiKey
user_id
ID de l’utilisateur.
200
OK
message
Message de résultat de suppression.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/users/{user_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/api/admin/users/{user_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"message": "ipsum eiusmod"
}{
"message": "ipsum eiusmod"
}Mettre à jour un utilisateur
PATCH /api/admin/users/{user_id}
Met à jour les rôles et sièges produits d’un Membre de l’Organisation.
AdminApiKey
user_id
ID de l’utilisateur.
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ôle à attribuer. Exclusif avec 'role_names'.
subscription_types
Sièges produits à attribuer au Membre.
200
OK
Adresse e-mail du Membre de l’Organisation.
is_sso_outsider
Indique si le Membre est en dehors du domaine SSO.
name
Nom du Membre de l’Organisation.
oid_id
ID du fournisseur d’identité pour le Membre.
raw_role
Rôle d'organisation obsolète. Utilisez plutôt "raw_roles".
raw_roles
Rôles d'organisation attribués au membre.
subscription_types
Sièges de produit attribués au membre.
uuid
ID du membre de l'organisation.
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/users/{user_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'curl https://api.mistral.ai/api/admin/users/{user_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'200
{
"email": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "ipsum eiusmod"
}{
"email": null,
"name": null,
"oid_id": null,
"raw_role": "A",
"raw_roles": [
"A"
],
"uuid": "ipsum eiusmod"
}Lister les rôles
GET /api/admin/roles
Liste les rôles d'organisation et les rôles d'espace de travail.
AdminApiKey
Playground
Testez les endpoints en direct
curl https://api.mistral.ai/api/admin/roles \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/api/admin/roles \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"organization_roles": [
{
"description": "ipsum eiusmod",
"is_custom_role": false,
"name": "consequat do",
"uuid": null
}
],
"workspace_roles": [
{
"description": "reprehenderit ut dolore",
"is_custom_role": false,
"name": "occaecat dolor sit",
"uuid": null
}
]
}{
"organization_roles": [
{
"description": "ipsum eiusmod",
"is_custom_role": false,
"name": "consequat do",
"uuid": null
}
],
"workspace_roles": [
{
"description": "reprehenderit ut dolore",
"is_custom_role": false,
"name": "occaecat dolor sit",
"uuid": null
}
]
}