> For the complete documentation index, see [llms.txt](https://www.center.daxium-air.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.center.daxium-air.com/api-reference/doc-api/utilisateurs.md).
# Utilisateurs
## Lister tous les utilisateurs
> Retourne tous les utilisateurs du compte. Cet endpoint n'est pas préfixé par \`{app\_short}\`.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"UserListResponse":{"type":"object","properties":{"users":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"User":{"type":"object","description":"Utilisateur (objet retourné par les API GET)","properties":{"id":{"type":"integer","description":"Identifiant unique généré par le système"},"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"first_name":{"type":"string","description":"Prénom"},"last_name":{"type":"string","description":"Nom"},"subscription_id":{"type":"string","description":"UUID de l'abonnement rattaché"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes de l'utilisateur","items":{"type":"integer"}},"settings":{"type":"object","description":"Paramètres de l'utilisateur (ex. langue/locale)","additionalProperties":true}}}}},"paths":{"/users":{"get":{"summary":"Lister tous les utilisateurs","description":"Retourne tous les utilisateurs du compte. Cet endpoint n'est pas préfixé par `{app_short}`.","tags":["users"],"operationId":"listAllUsers","responses":{"200":{"description":"Liste des utilisateurs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserListResponse"}}}}}}}}}
```
## Récupérer l'utilisateur courant
> Retourne l'utilisateur authentifié ainsi que le compte (société) associé.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"CurrentUserResponse":{"type":"object","properties":{"user":{"$ref":"#/components/schemas/User"},"company":{"$ref":"#/components/schemas/Company"}}},"User":{"type":"object","description":"Utilisateur (objet retourné par les API GET)","properties":{"id":{"type":"integer","description":"Identifiant unique généré par le système"},"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"first_name":{"type":"string","description":"Prénom"},"last_name":{"type":"string","description":"Nom"},"subscription_id":{"type":"string","description":"UUID de l'abonnement rattaché"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes de l'utilisateur","items":{"type":"integer"}},"settings":{"type":"object","description":"Paramètres de l'utilisateur (ex. langue/locale)","additionalProperties":true}}},"Company":{"type":"object","description":"Compte société de l'utilisateur courant","properties":{"created_at":{"type":"integer","format":"int64","description":"Date de création (timestamp UNIX)"},"updated_at":{"type":"integer","format":"int64","description":"Date de dernière mise à jour (timestamp UNIX)"},"id":{"type":"integer","description":"Identifiant"},"title":{"type":"string","description":"Nom affiché"}}}}},"paths":{"/users/me":{"get":{"summary":"Récupérer l'utilisateur courant","description":"Retourne l'utilisateur authentifié ainsi que le compte (société) associé.","tags":["users"],"operationId":"getCurrentUser","responses":{"200":{"description":"Utilisateur courant et société","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrentUserResponse"}}}}}}}}}
```
## Envoyer une clé push
> Enregistre une clé de notification push pour un appareil de l'utilisateur.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"PushKeyInput":{"type":"object","description":"Clé de notification push d'un appareil","properties":{"id":{"type":"string","description":"Identifiant unique de l'appareil"},"key":{"type":"string","description":"Clé push"},"os":{"type":"string","description":"Système d'exploitation de l'appareil (android ou iOS)"},"os_version":{"type":"string","description":"Version de l'OS"},"app_version":{"type":"string","description":"Version de Daxium-Air"},"name":{"type":"string","description":"Nom de l'appareil"}}}}},"paths":{"/users/pushkey":{"post":{"summary":"Envoyer une clé push","description":"Enregistre une clé de notification push pour un appareil de l'utilisateur.","tags":["users"],"operationId":"sendPushKey","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushKeyInput"}}}},"responses":{"200":{"description":"Clé push enregistrée","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```
## Lister les utilisateurs d'un vertical métier (ou rechercher par e-mail)
> Retourne les utilisateurs du vertical métier. Si le paramètre \`username\`\
> est fourni, retourne l'utilisateur unique correspondant à cet e-mail.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"UserListResponse":{"type":"object","properties":{"users":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"User":{"type":"object","description":"Utilisateur (objet retourné par les API GET)","properties":{"id":{"type":"integer","description":"Identifiant unique généré par le système"},"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"first_name":{"type":"string","description":"Prénom"},"last_name":{"type":"string","description":"Nom"},"subscription_id":{"type":"string","description":"UUID de l'abonnement rattaché"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes de l'utilisateur","items":{"type":"integer"}},"settings":{"type":"object","description":"Paramètres de l'utilisateur (ex. langue/locale)","additionalProperties":true}}}}},"paths":{"/{app_short}/users":{"get":{"summary":"Lister les utilisateurs d'un vertical métier (ou rechercher par e-mail)","description":"Retourne les utilisateurs du vertical métier. Si le paramètre `username`\nest fourni, retourne l'utilisateur unique correspondant à cet e-mail.\n","tags":["users"],"operationId":"listAppUsers","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"username","in":"query","description":"Adresse e-mail pour récupérer un utilisateur précis","schema":{"type":"string","format":"email"}}],"responses":{"200":{"description":"Liste d'utilisateurs, ou utilisateur unique si `username` est fourni","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UserListResponse"},{"$ref":"#/components/schemas/User"}]}}}}}}}}}
```
## Créer un utilisateur
> Crée un utilisateur. Fournissez \`plainPassword\` pour une authentification Daxium,\
> ou \`ssoProvider\` pour une authentification via le fournisseur SSO de la société.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"UserInput":{"type":"object","required":["username","system_groups"],"description":"Corps de création ou de mise à jour d'un utilisateur. Fournissez `plainPassword`\npour une authentification Daxium, ou `ssoProvider` pour une authentification SSO.\n","properties":{"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"firstName":{"type":"string","description":"Prénom"},"lastName":{"type":"string","description":"Nom"},"locale":{"type":"string","enum":["en","fr"],"description":"Langue de l'utilisateur"},"subscription_id":{"type":"string","description":"UUID de l'abonnement (voir l'API `/subscriptions`)"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes (voir l'API `/{app_short}/groups`)","items":{"type":"integer"}},"plainPassword":{"type":"object","description":"Mot de passe. Les clés `first` et `second` sont obligatoires et doivent être identiques.\nRègles : au moins 1 majuscule, 1 minuscule, 1 chiffre, 8 caractères au total.\n","properties":{"first":{"type":"string","format":"password"},"second":{"type":"string","format":"password"}}},"force_login_password":{"type":"integer","enum":[0,1],"description":"[Sociétés SSO uniquement] 0 pour désactiver, 1 pour forcer l'authentification login/mot de passe Daxium"},"ssoProvider":{"type":"integer","nullable":true,"description":"[Sociétés SSO uniquement] Identifiant du fournisseur SSO à utiliser (fourni par Daxium)"}}},"User":{"type":"object","description":"Utilisateur (objet retourné par les API GET)","properties":{"id":{"type":"integer","description":"Identifiant unique généré par le système"},"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"first_name":{"type":"string","description":"Prénom"},"last_name":{"type":"string","description":"Nom"},"subscription_id":{"type":"string","description":"UUID de l'abonnement rattaché"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes de l'utilisateur","items":{"type":"integer"}},"settings":{"type":"object","description":"Paramètres de l'utilisateur (ex. langue/locale)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/users":{"post":{"summary":"Créer un utilisateur","description":"Crée un utilisateur. Fournissez `plainPassword` pour une authentification Daxium,\nou `ssoProvider` pour une authentification via le fournisseur SSO de la société.\n","tags":["users"],"operationId":"createUser","parameters":[{"$ref":"#/components/parameters/AppShort"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInput"}}}},"responses":{"200":{"description":"Utilisateur créé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}},"400":{"description":"Données invalides (mot de passe, ssoProvider, groupes ou abonnement invalides)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"L'adresse e-mail (username) existe déjà","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Créer plusieurs utilisateurs (asynchrone)
> Crée jusqu'à 100 utilisateurs de manière asynchrone. Interrogez le \`callbackUrl\` retourné.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"UserInput":{"type":"object","required":["username","system_groups"],"description":"Corps de création ou de mise à jour d'un utilisateur. Fournissez `plainPassword`\npour une authentification Daxium, ou `ssoProvider` pour une authentification SSO.\n","properties":{"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"firstName":{"type":"string","description":"Prénom"},"lastName":{"type":"string","description":"Nom"},"locale":{"type":"string","enum":["en","fr"],"description":"Langue de l'utilisateur"},"subscription_id":{"type":"string","description":"UUID de l'abonnement (voir l'API `/subscriptions`)"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes (voir l'API `/{app_short}/groups`)","items":{"type":"integer"}},"plainPassword":{"type":"object","description":"Mot de passe. Les clés `first` et `second` sont obligatoires et doivent être identiques.\nRègles : au moins 1 majuscule, 1 minuscule, 1 chiffre, 8 caractères au total.\n","properties":{"first":{"type":"string","format":"password"},"second":{"type":"string","format":"password"}}},"force_login_password":{"type":"integer","enum":[0,1],"description":"[Sociétés SSO uniquement] 0 pour désactiver, 1 pour forcer l'authentification login/mot de passe Daxium"},"ssoProvider":{"type":"integer","nullable":true,"description":"[Sociétés SSO uniquement] Identifiant du fournisseur SSO à utiliser (fourni par Daxium)"}}},"CallbackUrlResponse":{"type":"object","properties":{"callbackUrl":{"type":"string","description":"URL à interroger pour suivre l'avancement du job asynchrone"}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/users/multiple":{"post":{"summary":"Créer plusieurs utilisateurs (asynchrone)","description":"Crée jusqu'à 100 utilisateurs de manière asynchrone. Interrogez le `callbackUrl` retourné.","tags":["users"],"operationId":"createMultipleUsers","parameters":[{"$ref":"#/components/parameters/AppShort"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/UserInput"}}}}},"responses":{"200":{"description":"Job asynchrone accepté","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackUrlResponse"}}}},"400":{"description":"Corps vide ou plus de 100 utilisateurs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Mettre à jour plusieurs utilisateurs (asynchrone)
> Met à jour jusqu'à 100 utilisateurs de manière asynchrone. Interrogez le \`callbackUrl\` retourné.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"UserInput":{"type":"object","required":["username","system_groups"],"description":"Corps de création ou de mise à jour d'un utilisateur. Fournissez `plainPassword`\npour une authentification Daxium, ou `ssoProvider` pour une authentification SSO.\n","properties":{"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"firstName":{"type":"string","description":"Prénom"},"lastName":{"type":"string","description":"Nom"},"locale":{"type":"string","enum":["en","fr"],"description":"Langue de l'utilisateur"},"subscription_id":{"type":"string","description":"UUID de l'abonnement (voir l'API `/subscriptions`)"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes (voir l'API `/{app_short}/groups`)","items":{"type":"integer"}},"plainPassword":{"type":"object","description":"Mot de passe. Les clés `first` et `second` sont obligatoires et doivent être identiques.\nRègles : au moins 1 majuscule, 1 minuscule, 1 chiffre, 8 caractères au total.\n","properties":{"first":{"type":"string","format":"password"},"second":{"type":"string","format":"password"}}},"force_login_password":{"type":"integer","enum":[0,1],"description":"[Sociétés SSO uniquement] 0 pour désactiver, 1 pour forcer l'authentification login/mot de passe Daxium"},"ssoProvider":{"type":"integer","nullable":true,"description":"[Sociétés SSO uniquement] Identifiant du fournisseur SSO à utiliser (fourni par Daxium)"}}},"CallbackUrlResponse":{"type":"object","properties":{"callbackUrl":{"type":"string","description":"URL à interroger pour suivre l'avancement du job asynchrone"}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Code d'erreur unique préfixé par `DAERR-`"},"message":{"type":"string","description":"Description lisible de l'erreur"},"url":{"type":"string","format":"uri","description":"Lien vers la documentation détaillée de l'erreur"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Informations contextuelles supplémentaires (peut être vide)"},"server_time":{"type":"string","description":"Timestamp Unix sous forme de chaîne"}}}}},"paths":{"/{app_short}/users/multiple":{"put":{"summary":"Mettre à jour plusieurs utilisateurs (asynchrone)","description":"Met à jour jusqu'à 100 utilisateurs de manière asynchrone. Interrogez le `callbackUrl` retourné.","tags":["users"],"operationId":"updateMultipleUsers","parameters":[{"$ref":"#/components/parameters/AppShort"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/UserInput"}}}}},"responses":{"200":{"description":"Job asynchrone accepté","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackUrlResponse"}}}},"400":{"description":"Corps vide ou plus de 100 utilisateurs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## GET /{app\_short}/users/multiple/callback/{callback\_id}
> Consulter le statut d'un job asynchrone d'utilisateurs
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"UsersCallbackResponse":{"type":"object","properties":{"callbackDetails":{"type":"object","properties":{"status":{"type":"string","enum":["Planned","Running","Finished","Finished with errors","Failed","In timeout"],"description":"Statut courant du job"},"nbRecordsTodo":{"type":"integer","description":"Nombre d'utilisateurs à traiter"},"nbRecordsDone":{"type":"integer","description":"Nombre d'utilisateurs déjà traités"},"nbSuccess":{"type":"integer","description":"Nombre d'utilisateurs traités avec succès"},"nbErrors":{"type":"integer","description":"Nombre d'utilisateurs en erreur"},"success":{"type":"array","description":"Utilisateurs créés/mis à jour avec succès. Format : {\"\": {\"id\": }}","items":{"type":"object","additionalProperties":true}},"errors":{"type":"array","description":"Erreurs par utilisateur. Format : {\"\": {\"\": [\"\"]}}","items":{"type":"object","additionalProperties":true}}}}}}}},"paths":{"/{app_short}/users/multiple/callback/{callback_id}":{"get":{"summary":"Consulter le statut d'un job asynchrone d'utilisateurs","tags":["users"],"operationId":"getMultipleUsersCallback","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"callback_id","in":"path","required":true,"description":"Identifiant de callback (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Statut et résultats par utilisateur","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsersCallbackResponse"}}}}}}}}}
```
## GET /{app\_short}/users/{user\_id}
> Récupérer un utilisateur par son identifiant
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"User":{"type":"object","description":"Utilisateur (objet retourné par les API GET)","properties":{"id":{"type":"integer","description":"Identifiant unique généré par le système"},"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"first_name":{"type":"string","description":"Prénom"},"last_name":{"type":"string","description":"Nom"},"subscription_id":{"type":"string","description":"UUID de l'abonnement rattaché"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes de l'utilisateur","items":{"type":"integer"}},"settings":{"type":"object","description":"Paramètres de l'utilisateur (ex. langue/locale)","additionalProperties":true}}}}},"paths":{"/{app_short}/users/{user_id}":{"get":{"summary":"Récupérer un utilisateur par son identifiant","tags":["users"],"operationId":"getUser","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"user_id","in":"path","required":true,"description":"Identifiant de l'utilisateur","schema":{"type":"integer"}}],"responses":{"200":{"description":"Objet utilisateur","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}}}}}}}
```
## PATCH /{app\_short}/users/{user\_id}
> Mettre à jour un utilisateur
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"users"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"UserInput":{"type":"object","required":["username","system_groups"],"description":"Corps de création ou de mise à jour d'un utilisateur. Fournissez `plainPassword`\npour une authentification Daxium, ou `ssoProvider` pour une authentification SSO.\n","properties":{"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"firstName":{"type":"string","description":"Prénom"},"lastName":{"type":"string","description":"Nom"},"locale":{"type":"string","enum":["en","fr"],"description":"Langue de l'utilisateur"},"subscription_id":{"type":"string","description":"UUID de l'abonnement (voir l'API `/subscriptions`)"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes (voir l'API `/{app_short}/groups`)","items":{"type":"integer"}},"plainPassword":{"type":"object","description":"Mot de passe. Les clés `first` et `second` sont obligatoires et doivent être identiques.\nRègles : au moins 1 majuscule, 1 minuscule, 1 chiffre, 8 caractères au total.\n","properties":{"first":{"type":"string","format":"password"},"second":{"type":"string","format":"password"}}},"force_login_password":{"type":"integer","enum":[0,1],"description":"[Sociétés SSO uniquement] 0 pour désactiver, 1 pour forcer l'authentification login/mot de passe Daxium"},"ssoProvider":{"type":"integer","nullable":true,"description":"[Sociétés SSO uniquement] Identifiant du fournisseur SSO à utiliser (fourni par Daxium)"}}},"User":{"type":"object","description":"Utilisateur (objet retourné par les API GET)","properties":{"id":{"type":"integer","description":"Identifiant unique généré par le système"},"username":{"type":"string","format":"email","description":"Adresse e-mail (identifiant de connexion), unique"},"active":{"type":"boolean","description":"Statut (actif / inactif)"},"first_name":{"type":"string","description":"Prénom"},"last_name":{"type":"string","description":"Nom"},"subscription_id":{"type":"string","description":"UUID de l'abonnement rattaché"},"system_groups":{"type":"array","description":"Groupes système : 1 = administrateur, 2 = accès mobile, 3 = accès web","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiants des groupes de l'utilisateur","items":{"type":"integer"}},"settings":{"type":"object","description":"Paramètres de l'utilisateur (ex. langue/locale)","additionalProperties":true}}}}},"paths":{"/{app_short}/users/{user_id}":{"patch":{"summary":"Mettre à jour un utilisateur","tags":["users"],"operationId":"updateUser","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"user_id","in":"path","required":true,"description":"Identifiant de l'utilisateur","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInput"}}}},"responses":{"200":{"description":"Utilisateur mis à jour","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://www.center.daxium-air.com/api-reference/doc-api/utilisateurs.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.