# Autorisations d'accès aux listes
## Lister toutes les autorisations d'accès
> Retourne toutes les autorisations d'accès définies dans l'instance.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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":{"ListAccessSetSummary":{"type":"object","description":"Résumé d'une autorisation d'accès","properties":{"id":{"type":"string","format":"uuid","description":"Identifiant de l'autorisation d'accès"},"name":{"type":"string","description":"Nom de l'autorisation d'accès"},"users":{"type":"array","items":{"type":"string"},"description":"Identifiants des utilisateurs"},"groups":{"type":"array","items":{},"description":"Groupes inclus"},"root_id":{"type":"integer","description":"Identifiant du nœud racine de la liste"},"lists":{"type":"array","items":{"type":"integer"},"description":"Identifiants des éléments de liste restreints"}}}}},"paths":{"/{app_short}/list/accessset":{"get":{"summary":"Lister toutes les autorisations d'accès","description":"Retourne toutes les autorisations d'accès définies dans l'instance.","tags":["list-access"],"operationId":"listAccessSets","parameters":[{"$ref":"#/components/parameters/AppShort"}],"responses":{"200":{"description":"Toutes les autorisations d'accès","content":{"application/json":{"schema":{"type":"object","properties":{"listaccesssets":{"type":"array","items":{"$ref":"#/components/schemas/ListAccessSetSummary"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}}}}}}}}}}
```
## Créer une autorisation d'accès
> Crée une nouvelle autorisation d'accès restreignant la visibilité d'éléments de liste.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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"}}}},"paths":{"/{app_short}/list/{root_id}/accessset":{"post":{"summary":"Créer une autorisation d'accès","description":"Crée une nouvelle autorisation d'accès restreignant la visibilité d'éléments de liste.","tags":["list-access"],"operationId":"createAccessSet","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant du nœud racine de la liste","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Nom de l'autorisation d'accès"},"groups":{"type":"array","items":{"type":"integer"},"description":"Identifiants des groupes à inclure"},"users":{"type":"array","items":{"type":"integer"},"description":"Identifiants des utilisateurs à inclure"},"lists":{"type":"array","items":{"type":"integer"},"description":"Identifiants des éléments de liste à restreindre"}}}}}},"responses":{"200":{"description":"Autorisation d'accès créée","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}}}}}}}}}}}
```
## Récupérer les autorisations d'accès pour une liste et un utilisateur
> Retourne les identifiants de toutes les autorisations définies pour une liste et un utilisateur donnés.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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"}}}},"paths":{"/{app_short}/list/{list_id}/accessset/user/{user_id}":{"get":{"summary":"Récupérer les autorisations d'accès pour une liste et un utilisateur","description":"Retourne les identifiants de toutes les autorisations définies pour une liste et un utilisateur donnés.","tags":["list-access"],"operationId":"getAccessSetsForUser","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant de la liste","schema":{"type":"integer"}},{"name":"user_id","in":"path","required":true,"description":"Identifiant de l'utilisateur","schema":{"type":"integer"}}],"responses":{"200":{"description":"UUIDs des autorisations d'accès pour cet utilisateur et cette liste","content":{"application/json":{"schema":{"type":"array","items":{"type":"string","format":"uuid"}}}}}}}}}}
```
## Récupérer les détails d'une autorisation d'accès
> Retourne les détails complets d'une autorisation d'accès.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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":{"ListAccessSetDetail":{"type":"object","description":"Détails complets d'une autorisation d'accès","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserRef"},"description":"Utilisateurs inclus"},"groups":{"type":"array","items":{},"description":"Groupes inclus"},"root_id":{"type":"object","description":"Nœud racine associé","properties":{"id":{"type":"integer"},"name":{"type":"string"},"level":{"type":"integer"},"position":{"type":"integer"},"has_image":{"type":"boolean"}}},"lists":{"type":"array","items":{"$ref":"#/components/schemas/ListItem"},"description":"Éléments de liste restreints"}}},"UserRef":{"type":"object","description":"Référence à un utilisateur","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"first_name":{"type":"string","description":"Prénom"},"last_name":{"type":"string","description":"Nom"},"groups":{"type":"array","items":{},"description":"Groupes de l'utilisateur"},"system_groups":{"type":"array","items":{},"description":"Groupes système de l'utilisateur"}}},"ListItem":{"type":"object","description":"Élément de liste","properties":{"id":{"type":"integer","description":"Identifiant de l'élément"},"root_id":{"type":"integer","description":"Identifiant du nœud racine"},"parent_id":{"type":"integer","description":"Identifiant du parent"},"created_at":{"type":"integer","format":"int64","description":"Date de création (timestamp UNIX)"},"updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour (timestamp UNIX)"},"deleted_at":{"type":"integer","format":"int64","nullable":true,"description":"Date de suppression (timestamp UNIX)"},"name":{"type":"string","description":"Nom affiché"},"has_image":{"type":"boolean","description":"Indique si l'élément possède une image"},"level":{"type":"integer","description":"Niveau de profondeur — 0 est le nœud racine"},"position":{"type":"integer","description":"Position à son niveau de profondeur"},"external_id":{"type":"string","description":"Identifiant externe"},"url":{"type":"string","description":"URL associée à l'élément"},"functionnal_status_color":{"type":"string","description":"Couleur de l'élément (hexadécimal)"}}}}},"paths":{"/{app_short}/list/{list_id}/accessset/{list_access_set_id}":{"get":{"summary":"Récupérer les détails d'une autorisation d'accès","description":"Retourne les détails complets d'une autorisation d'accès.","tags":["list-access"],"operationId":"getAccessSet","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant de la liste","schema":{"type":"integer"}},{"name":"list_access_set_id","in":"path","required":true,"description":"Identifiant de l'autorisation d'accès (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Détails complets de l'autorisation d'accès","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAccessSetDetail"}}}}}}}}}
```
## DELETE /{app\_short}/list/{list\_id}/accessset/{list\_access\_set\_id}
> Supprimer une autorisation d'accès
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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"}}}},"paths":{"/{app_short}/list/{list_id}/accessset/{list_access_set_id}":{"delete":{"summary":"Supprimer une autorisation d'accès","tags":["list-access"],"operationId":"deleteAccessSet","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant de la liste","schema":{"type":"integer"}},{"name":"list_access_set_id","in":"path","required":true,"description":"Identifiant de l'autorisation d'accès (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Autorisation d'accès supprimée"}}}}}}
```
## Générer les dépendances d'une autorisation d'accès
> Recalcule immédiatement toutes les dépendances internes de l'autorisation d'accès.\
> S'exécute automatiquement toutes les 5 minutes ; à appeler manuellement après des modifications en lot.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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"}}}},"paths":{"/{app_short}/list/{list_id}/accessset/{list_access_set_id}/generate":{"post":{"summary":"Générer les dépendances d'une autorisation d'accès","description":"Recalcule immédiatement toutes les dépendances internes de l'autorisation d'accès.\nS'exécute automatiquement toutes les 5 minutes ; à appeler manuellement après des modifications en lot.\n","tags":["list-access"],"operationId":"generateAccessSetDependencies","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant de la liste","schema":{"type":"integer"}},{"name":"list_access_set_id","in":"path","required":true,"description":"Identifiant de l'autorisation d'accès (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Dépendances régénérées"}}}}}}
```
## Récupérer les entités d'une autorisation d'accès
> Retourne les utilisateurs, groupes ou éléments de liste appartenant à l'autorisation.\
> Utilisez \`users\`, \`groups\` ou \`lists\` comme valeur du paramètre \`entity\`.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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"}}}},"paths":{"/{app_short}/list/{list_id}/accessset/{list_access_set_id}/{entity}":{"get":{"summary":"Récupérer les entités d'une autorisation d'accès","description":"Retourne les utilisateurs, groupes ou éléments de liste appartenant à l'autorisation.\nUtilisez `users`, `groups` ou `lists` comme valeur du paramètre `entity`.\n","tags":["list-access"],"operationId":"getAccessSetEntity","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant de la liste","schema":{"type":"integer"}},{"name":"list_access_set_id","in":"path","required":true,"description":"Identifiant de l'autorisation d'accès (UUID)","schema":{"type":"string","format":"uuid"}},{"name":"entity","in":"path","required":true,"description":"Type d'entité à retourner","schema":{"type":"string","enum":["users","groups","lists"]}}],"responses":{"200":{"description":"Tableau du type d'entité demandé","content":{"application/json":{"schema":{"type":"array","items":{}}}}}}}}}}
```
## Ajouter une entité à une autorisation d'accès
> Ajoute un utilisateur, groupe ou élément de liste à l'autorisation d'accès.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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"}}}},"paths":{"/{app_short}/list/{list_id}/accessset/{list_access_set_id}/{entity}/{entity_id}":{"put":{"summary":"Ajouter une entité à une autorisation d'accès","description":"Ajoute un utilisateur, groupe ou élément de liste à l'autorisation d'accès.","tags":["list-access"],"operationId":"addAccessSetEntity","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant de la liste","schema":{"type":"integer"}},{"name":"list_access_set_id","in":"path","required":true,"description":"Identifiant de l'autorisation d'accès (UUID)","schema":{"type":"string","format":"uuid"}},{"name":"entity","in":"path","required":true,"description":"Type d'entité","schema":{"type":"string","enum":["users","groups","lists"]}},{"name":"entity_id","in":"path","required":true,"description":"Identifiant de l'utilisateur, groupe ou élément à ajouter","schema":{"type":"integer"}}],"responses":{"200":{"description":"Entité ajoutée"}}}}}}
```
## Retirer une entité d'une autorisation d'accès
> Retire un utilisateur, groupe ou élément de liste de l'autorisation d'accès.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"list-access"}],"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"}}}},"paths":{"/{app_short}/list/{list_id}/accessset/{list_access_set_id}/{entity}/{entity_id}":{"delete":{"summary":"Retirer une entité d'une autorisation d'accès","description":"Retire un utilisateur, groupe ou élément de liste de l'autorisation d'accès.","tags":["list-access"],"operationId":"deleteAccessSetEntity","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant de la liste","schema":{"type":"integer"}},{"name":"list_access_set_id","in":"path","required":true,"description":"Identifiant de l'autorisation d'accès (UUID)","schema":{"type":"string","format":"uuid"}},{"name":"entity","in":"path","required":true,"description":"Type d'entité","schema":{"type":"string","enum":["users","groups","lists"]}},{"name":"entity_id","in":"path","required":true,"description":"Identifiant de l'utilisateur, groupe ou élément à retirer","schema":{"type":"integer"}}],"responses":{"204":{"description":"Entité retirée"}}}}}}
```
---
# Agent Instructions: 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:
```
GET https://www.center.daxium-air.com/api-reference/doc-api/listes/autorisations-dacces-aux-listes.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.