> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/api-reference/efalia-doc-api/utilisateurs.md).

# Utilisateurs

## POST /api/utilisateurs/recherche

> Recherche d'utilisateurs par leur identifiant ou nom

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"UtilisateurId":{"type":"string","format":"uuid"},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/recherche":{"post":{"operationId":"rechercherUtilisateur","summary":"Recherche d'utilisateurs par leur identifiant ou nom","tags":["Utilisateurs"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["recherche"],"properties":{"recherche":{"type":"string","title":"Identifiant ou nom complet","description":"Il s'agit d'une recherche exacte sur l'identifiant et une recherche partielle sur le nom.","minLength":1}}}}}},"responses":{"200":{"description":"La liste des utilisateurs trouvés","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Utilisateur"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## GET /api/utilisateurs

> Lister les utilisateurs

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"parameters":{"Range":{"in":"header","name":"Range","description":"Header pour spécifier la tranche d'objets à sélectionner.\n\nSi aucune pagination n'est demandée la réponse contiendra au maximum `1000` objets, veuillez donc vérifier le code retour de la réponse pour vérifier si vous devez faire d'autres appels pour récupérer les autres objets.\n\nLa tranche maximum est de `1000` objets, si vous demandez plus alors la réponse contiendra au maximum `1000` objets. Il faut donc bien prendre en compte le header `Content-Range` contenu dans la réponse.","schema":{"type":"string","description":"Si vous voulez paginer par tranches de 10, il faudra utiliser les tranches `0-9`, `10-19`, `20-29`, etc...","pattern":"^resources (\\d+)-(\\d+)$"}}},"schemas":{"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"UtilisateurId":{"type":"string","format":"uuid"},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"headers":{"ContentRange":{"schema":{"type":"string","description":"`Content-Range: 0-99/500` indique que la réponse contient les `100` premiers objets. Le header de réponse `Content-Range: 500-504/505` indique qu'on est arrivé à la fin"}}},"responses":{"PaginationRangeErronee":{"description":"Les bornes pour la pagination demandée sont erronées","content":{"application/json":{"schema":{"title":"Requete invalide","type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["erreur_borne_pagination"]},"message":{"type":"string"}}}}}},"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"PaginationImpossible":{"description":"La pagination demandée dépasse les données disponibles","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs":{"get":{"operationId":"utilisateurs","summary":"Lister les utilisateurs","tags":["Utilisateurs","Admin"],"parameters":[{"$ref":"#/components/parameters/Range"}],"responses":{"200":{"description":"Un tableau JSON des utilisateurs","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Utilisateur"}}}}},"206":{"description":"Un tableau JSON des utilisateurs pour la tranche demandée","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Utilisateur"}}}},"headers":{"Content-Range":{"$ref":"#/components/headers/ContentRange"}}},"400":{"$ref":"#/components/responses/PaginationRangeErronee"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"416":{"$ref":"#/components/responses/PaginationImpossible"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## POST /api/utilisateurs

> Créer un utilisateur

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"UtilisateurId":{"type":"string","format":"uuid"},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs":{"post":{"operationId":"creerUtilisateur","summary":"Créer un utilisateur","tags":["Utilisateurs","Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["identifiant","motDePasse","nomComplet","email","estAdministrateur"],"properties":{"identifiant":{"type":"string","maxLength":255},"motDePasse":{"type":"string"},"nomComplet":{"type":"string","maxLength":255},"email":{"type":"string","maxLength":255,"format":"email"},"estAdministrateur":{"type":"boolean"}}}}}},"responses":{"201":{"description":"Utilisateur créé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"400":{"description":"Les données sont invalides","content":{"application/json":{"schema":{"title":"Requete invalide","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["email_invalide","mot_de_passe_ne_peut_pas_etre_vide","mot_de_passe_trop_court","identifiant_ne_peut_pas_etre_vide","identifiant_deja_utilise","format_payload_invalide"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## PUT /api/utilisateurs/{id}/mot-de-passe

> Modifier le mot de passe d'un utilisateur

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"UtilisateurId":{"type":"string","format":"uuid"},"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/{id}/mot-de-passe":{"put":{"operationId":"modifierMotDePasse","summary":"Modifier le mot de passe d'un utilisateur","tags":["Utilisateurs","Admin"],"parameters":[{"in":"path","name":"id","description":"L'id de l'utilisateur","required":true,"schema":{"$ref":"#/components/schemas/UtilisateurId"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["motDePasse"],"properties":{"motDePasse":{"type":"string","description":"Le nouveau mot de passe"}}}}}},"responses":{"200":{"description":"Mot de passe modifié","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"400":{"description":"Le mot de passe est invalide","content":{"application/json":{"schema":{"title":"Requete invalide","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mot_de_passe_ne_peut_pas_etre_vide","mot_de_passe_trop_court","mot_de_passe_ldap_non_modifiable","mot_de_passe_mglogin_non_modifiable","format_payload_invalide"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"L'utilisateur n'existe pas","content":{"application/json":{"schema":{"title":"Utilisateur inexistant","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_inexistant"]}}}}}},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## PUT /api/utilisateurs/mot-de-passe

> Modifier le mot de passe de l'utilisateur connecté

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"UtilisateurId":{"type":"string","format":"uuid"},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/mot-de-passe":{"put":{"operationId":"modifierMonMotDePasse","summary":"Modifier le mot de passe de l'utilisateur connecté","tags":["Utilisateurs"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["motDePasse"],"properties":{"motDePasse":{"type":"string"}}}}}},"responses":{"200":{"description":"Mot de passe modifié","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"400":{"description":"Le mot de passe de l'utilisateur est vide","content":{"application/json":{"schema":{"title":"Le mot de passe de l'utilisateur est vide","type":"object","required":["code"],"properties":{"code":{"type":"string","enum":["format_payload_invalide","mot_de_passe_ne_peut_pas_etre_vide","mot_de_passe_trop_court"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## GET /api/utilisateurs/{id}

> Récupérer un utilisateur par son identifiant

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"UtilisateurId":{"type":"string","format":"uuid"},"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/{id}":{"get":{"operationId":"recupererUtilisateur","summary":"Récupérer un utilisateur par son identifiant","tags":["Utilisateurs","Admin"],"parameters":[{"in":"path","name":"id","description":"L'identifiant de l'utilisateur","required":true,"schema":{"$ref":"#/components/schemas/UtilisateurId"}}],"responses":{"200":{"description":"L'utilisateur trouvé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"L'utilisateur demandé n'existe pas","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_inexistant"]}}}}}},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## PUT /api/utilisateurs/{id}

> Modification d'un utilisateur

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"UtilisateurId":{"type":"string","format":"uuid"},"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/{id}":{"put":{"operationId":"modifierUtilisateur","summary":"Modification d'un utilisateur","tags":["Utilisateurs","Admin"],"parameters":[{"in":"path","name":"id","description":"L'id de l'utilisateur","required":true,"schema":{"$ref":"#/components/schemas/UtilisateurId"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["nomComplet","email","estAdministrateur"],"properties":{"nomComplet":{"type":"string","maxLength":255},"email":{"type":"string","maxLength":255,"format":"email"},"estAdministrateur":{"type":"boolean"}}}}}},"responses":{"200":{"description":"L'utilisateur a été modifié","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"400":{"description":"L'email est invalide","content":{"application/json":{"schema":{"title":"Requete invalide","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["email_invalide","format_payload_invalide"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"L'utilisateur n'existe pas","content":{"application/json":{"schema":{"title":"Utilisateur inexistant","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_inexistant"]}}}}}},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## DELETE /api/utilisateurs/{id}

> Suppression d'un utilisateur

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"UtilisateurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/{id}":{"delete":{"operationId":"supprimerUtilisateur","summary":"Suppression d'un utilisateur","tags":["Utilisateurs","Admin"],"parameters":[{"in":"path","name":"id","description":"L'id de l'utilisateur","required":true,"schema":{"$ref":"#/components/schemas/UtilisateurId"}}],"responses":{"204":{"description":"L'utilisateur a été supprimé"},"400":{"description":"L'utilisateur est utilisé dans un filtre, dans un document ou dans un dossier","content":{"application/json":{"schema":{"title":"Utilisateur utilisé dans un filtre","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_utilise_dans_un_filtre","utilisateur_utilise_dans_un_document","utilisateur_utilise_dans_un_dossier","utilisateur_utilise_dans_un_processus"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"L'utilisateur n'existe pas","content":{"application/json":{"schema":{"title":"Utilisateur inexistant","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_inexistant"]}}}}}},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## POST /api/utilisateurs/{id}/changement-mot-de-passe

> Active ou désactive le changement du mot de passe d'un utilisateur à la prochaine connexion

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"UtilisateurId":{"type":"string","format":"uuid"},"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/{id}/changement-mot-de-passe":{"post":{"operationId":"activerChangementMotDePasseUtilisateur","summary":"Active ou désactive le changement du mot de passe d'un utilisateur à la prochaine connexion","tags":["Utilisateurs","Admin"],"parameters":[{"in":"path","name":"id","description":"L'id de l'utilisateur","required":true,"schema":{"$ref":"#/components/schemas/UtilisateurId"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["active"],"properties":{"active":{"type":"boolean"}}}}}},"responses":{"200":{"description":"L'état du changement de mot de passe de l'utilisateur a été changé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"L'utilisateur n'existe pas","content":{"application/json":{"schema":{"title":"Utilisateur inexistant","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_inexistant"]}}}}}},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## POST /api/utilisateurs/{id}/activation

> Activation et désactivation d'un utilisateur

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"UtilisateurId":{"type":"string","format":"uuid"},"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/{id}/activation":{"post":{"operationId":"activerUtilisateur","summary":"Activation et désactivation d'un utilisateur","tags":["Utilisateurs","Admin"],"parameters":[{"in":"path","name":"id","description":"L'id de l'utilisateur","required":true,"schema":{"$ref":"#/components/schemas/UtilisateurId"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["estActif"],"properties":{"estActif":{"type":"boolean"}}}}}},"responses":{"200":{"description":"L'état d'activation de l'utilisateur a été changé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"L'utilisateur n'existe pas","content":{"application/json":{"schema":{"title":"Utilisateur inexistant","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_inexistant"]}}}}}},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## PUT /api/utilisateurs/{id}/attribution-licence-pcu

> Attribution ou non d'une licence PCU à l'utilisateur

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"UtilisateurId":{"type":"string","format":"uuid"},"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"RoleId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/{id}/attribution-licence-pcu":{"put":{"operationId":"attribuerLicencePCU","summary":"Attribution ou non d'une licence PCU à l'utilisateur","tags":["Utilisateurs"],"parameters":[{"in":"path","name":"id","description":"L'id de l'utilisateur","required":true,"schema":{"$ref":"#/components/schemas/UtilisateurId"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["attribuee"],"properties":{"attribuee":{"type":"boolean"}}}}}},"responses":{"200":{"description":"L'attribution de la licence a été changé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"400":{"description":"Toutes les licences ont été attribuées","content":{"application/json":{"schema":{"title":"Aucune licence disponible","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["aucune_licence_pcu_disponible"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"L'utilisateur n'existe pas","content":{"application/json":{"schema":{"title":"Utilisateur inexistant","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_inexistant"]}}}}}},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## GET /api/utilisateurs/licences-pcu/etat

> Etat des licences PCU

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/licences-pcu/etat":{"get":{"operationId":"etatLicencesPCU","summary":"Etat des licences PCU","tags":["Utilisateurs"],"responses":{"200":{"description":"Etat des licences PCU","content":{"application/json":{"schema":{"type":"object","properties":{"attribuees":{"type":"integer"},"licences":{"type":"integer"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## PUT /api/utilisateurs/{id}/filtres-acces/{filtre}

> Sélectionner une valeur d'un filtre d'accès à un utilisateur

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Filtres Accès"},{"name":"Admin"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"UtilisateurId":{"type":"string","format":"uuid"},"FiltreAccesId":{"type":"string","format":"uuid"},"FiltreAccesValeurId":{"type":"string","format":"uuid"},"Utilisateur":{"type":"object","required":["id","identifiant","nomComplet","email","estAdministrateur","estActif","roles","vientDuLdap","vientDeMgLogin","filtresAcces","doitChangerMotDePasse","licencePcuAttribuee"],"properties":{"id":{"$ref":"#/components/schemas/UtilisateurId"},"identifiant":{"type":"string"},"nomComplet":{"type":"string"},"email":{"type":"string"},"estAdministrateur":{"type":"boolean"},"estActif":{"type":"boolean"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleId"}},"vientDuLdap":{"type":"boolean"},"vientDeMgLogin":{"type":"boolean"},"filtresAcces":{"type":"array","items":{"type":"object","required":["filtre","valeurs"],"properties":{"filtre":{"$ref":"#/components/schemas/FiltreAccesId"},"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"}}}},"description":"Les filtres sans valeur n'apparaissent pas"},"doitChangerMotDePasse":{"type":"boolean"},"licencePcuAttribuee":{"type":"boolean"}}},"RoleId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"UnsupportedMediaType":{"description":"Le format de la requête n'est pas supporté","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateurs/{id}/filtres-acces/{filtre}":{"put":{"operationId":"selectionnerFiltresAccesUtilisateur","summary":"Sélectionner une valeur d'un filtre d'accès à un utilisateur","tags":["Utilisateurs","Filtres Accès","Admin"],"parameters":[{"in":"path","name":"id","description":"L'id de l'utilisateur","required":true,"schema":{"$ref":"#/components/schemas/UtilisateurId"}},{"in":"path","name":"filtre","description":"L'id du filtre d'accès","required":true,"schema":{"$ref":"#/components/schemas/FiltreAccesId"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["valeurs"],"properties":{"valeurs":{"type":"array","items":{"$ref":"#/components/schemas/FiltreAccesValeurId"},"description":"Un tableau vide va supprimer la sélection"}}}}}},"responses":{"200":{"description":"Valeur assignée à l'utilisateur","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilisateur"}}}},"400":{"description":"Le filtre référence une liste d'utilisateurs","content":{"application/json":{"schema":{"title":"Requete invalide","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["filtre_reference_liste_utilisateurs"]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"404":{"description":"L'utilisateur, le filtre d'accès ou la valeur n'existe pas","content":{"application/json":{"schema":{"title":"Utilisateur inexistant","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["utilisateur_inexistant","filtre_acces_inexistant","filtre_acces_valeur_inexistante"]}}}}}},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## GET /api/utilisateur-connecte/habilitations

> Récupérer les habilitations de l'utilisateur connecté

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]},{"ApiKey":[],"Impersonification":[]},{"ApiKey":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"},"ApiKey":{"type":"apiKey","name":"x-api-key","in":"header","description":"Clé d'API définie dans le manifeste de Doc dans la partie `Efalia Process > Clé API`."}},"schemas":{"GabaritDeDossierId":{"type":"string","format":"uuid"},"GabaritDeDocumentId":{"type":"string","format":"uuid"},"BannetteId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateur-connecte/habilitations":{"get":{"operationId":"habilitationsUtilisateurConnecte","summary":"Récupérer les habilitations de l'utilisateur connecté","tags":["Utilisateurs"],"responses":{"200":{"description":"Liste des habilitations pour chaque gabarit","content":{"application/json":{"schema":{"title":"MesHabilitations","type":"object","required":["gabaritsDeDossier","gabaritsDeDocument","bannettes"],"properties":{"gabaritsDeDossier":{"type":"array","items":{"type":"object","required":["id","consulter","supprimer","modifier","diffuser","ajouter"],"properties":{"id":{"$ref":"#/components/schemas/GabaritDeDossierId"},"consulter":{"type":"boolean"},"supprimer":{"type":"boolean"},"modifier":{"type":"boolean"},"diffuser":{"type":"boolean"},"ajouter":{"type":"boolean"}}}},"gabaritsDeDocument":{"type":"array","items":{"type":"object","required":["id","consulter","supprimer","modifier","diffuser","ajouter"],"properties":{"id":{"$ref":"#/components/schemas/GabaritDeDocumentId"},"consulter":{"type":"boolean"},"supprimer":{"type":"boolean"},"modifier":{"type":"boolean"},"diffuser":{"type":"boolean"},"ajouter":{"type":"boolean"}}}},"bannettes":{"type":"array","items":{"type":"object","required":["id","consulter","supprimer","modifier","diffuser","ajouter"],"properties":{"id":{"$ref":"#/components/schemas/BannetteId"},"consulter":{"type":"boolean"},"supprimer":{"type":"boolean"},"modifier":{"type":"boolean"},"diffuser":{"type":"boolean"},"ajouter":{"type":"boolean"}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```

## GET /api/utilisateur-connecte/processus

> Récupérer les processus Efalia Process de l'utilisateur connecté

```json
{"openapi":"3.1.0","info":{"title":"Efalia Doc","version":"1.0.0"},"tags":[{"name":"Utilisateurs"},{"name":"Efalia Process"}],"servers":[{"url":"https://interne.efalia.cloud:1202/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"Value: Bearer {jwt}"}},"schemas":{"GabaritDeDocumentId":{"type":"string","format":"uuid"}},"responses":{"Unauthorized":{"description":"Le JWT a expiré","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"NonHabilite":{"description":"L'utilisateur n'est pas habilité à faire l'action","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["non_habilite","changement_mot_de_passe_requis"]}}}}}},"ApiUnavailable":{"description":"L'api n'est actuellement pas disponible","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["mise_a_jour_api_en_cours"]}}}}}}}},"paths":{"/api/utilisateur-connecte/processus":{"get":{"operationId":"processusUtilisateurConnecte","summary":"Récupérer les processus Efalia Process de l'utilisateur connecté","tags":["Utilisateurs","Efalia Process"],"responses":{"200":{"description":"Liste des processus Efalia Process.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["processus"],"properties":{"processus":{"type":"object","required":["id","nom"],"properties":{"id":{"type":"string"},"nom":{"type":"string"}}},"gabaritDeDocument":{"description":"Si la propriété `gabaritDeDocument` est absente alors le processus est applicable à tous les gabarits.","type":"object","required":["id"],"properties":{"id":{"$ref":"#/components/schemas/GabaritDeDocumentId"}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/NonHabilite"},"500":{"description":"Erreur Efalia Process","content":{"application/json":{"schema":{"title":"Erreur Efalia Process","type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string","enum":["efalia_process_indisponible"]}}}}}},"503":{"$ref":"#/components/responses/ApiUnavailable"}}}}}}
```


---

# 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://documentation.efalia.com/api-reference/efalia-doc-api/utilisateurs.md?ask=<question>&goal=<endgoal>
```

`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.
