# Listes
## Lister toutes les listes (identifiants racine uniquement)
> Retourne tous les identifiants racine des listes de l'instance, sans leurs éléments enfants.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"ListPagedResponse":{"type":"object","properties":{"lists":{"type":"array","items":{"type":"object","properties":{"root_id":{"type":"integer","description":"Identifiant racine"},"name":{"type":"string","description":"Nom de la liste"},"created_at":{"type":"integer","format":"int64"},"list_last_updated":{"type":"integer","format":"int64","description":"Date de la dernière modification d'un élément de la liste"}}}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}}}},"paths":{"/{app_short}/lists":{"get":{"summary":"Lister toutes les listes (identifiants racine uniquement)","description":"Retourne tous les identifiants racine des listes de l'instance, sans leurs éléments enfants.","tags":["lists"],"operationId":"listLists","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"per_page","in":"query","description":"Nombre de listes par page (défaut 10, maximum 1000)","schema":{"type":"integer","default":10,"maximum":1000}},{"name":"page","in":"query","description":"Numéro de page (base 0)","schema":{"type":"integer","default":0}},{"name":"updated_since","in":"query","description":"Ne retourner que les listes modifiées après cette date (y compris supprimées)","schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Entrées racine paginées","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListPagedResponse"}}}}}}}}}
```
## Créer une liste
> Crée un nœud racine avec des enfants hiérarchiques optionnels via \`items\`.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"ListCreateRequest":{"type":"object","required":["name"],"description":"Corps de création d'une liste","properties":{"name":{"type":"string","description":"Nom de la liste (obligatoire)"},"external_id":{"type":"string","description":"Identifiant externe"},"items":{"type":"array","description":"Éléments enfants imbriqués (récursif)","items":{"$ref":"#/components/schemas/ListCreateRequest"}}}},"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}/lists":{"post":{"summary":"Créer une liste","description":"Crée un nœud racine avec des enfants hiérarchiques optionnels via `items`.","tags":["lists"],"operationId":"createList","parameters":[{"$ref":"#/components/parameters/AppShort"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCreateRequest"}}}},"responses":{"201":{"description":"Nœud racine créé","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItem"}}}}}}}}}
```
## Importer une liste depuis un CSV (asynchrone)
> Importe ou synchronise les données d'une liste depuis un fichier CSV préalablement envoyé.\
> Interrogez le \`callbackUrl\` retourné pour suivre l'avancement.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"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}/lists/import":{"post":{"summary":"Importer une liste depuis un CSV (asynchrone)","description":"Importe ou synchronise les données d'une liste depuis un fichier CSV préalablement envoyé.\nInterrogez le `callbackUrl` retourné pour suivre l'avancement.\n","tags":["lists"],"operationId":"importList","parameters":[{"$ref":"#/components/parameters/AppShort"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["list_id","file_id"],"properties":{"list_id":{"type":"integer","description":"Identifiant de la liste cible"},"file_id":{"type":"string","format":"uuid","description":"UUID du fichier (via l'endpoint d'envoi de fichier)"},"separator":{"type":"string","default":";","description":"Séparateur de colonnes du CSV"},"mode":{"type":"string","enum":["APPEND","DIFF"],"description":"Mode d'import"},"encoding":{"type":"string","enum":["UTF-8","WINDOWS-1252","WINDOWS-1256"],"default":"UTF-8","description":"Encodage du fichier"}}}}}},"responses":{"200":{"description":"Job asynchrone accepté","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackUrlResponse"}}}},"400":{"description":"Erreur de validation (file_id manquant, encodage incorrect, fichier introuvable, etc.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Récupérer les identifiants de listes et d'autorisations modifiés
> Retourne les identifiants des listes et autorisations d'accès nécessitant une synchronisation.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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}/lists/updated":{"post":{"summary":"Récupérer les identifiants de listes et d'autorisations modifiés","description":"Retourne les identifiants des listes et autorisations d'accès nécessitant une synchronisation.","tags":["lists"],"operationId":"getUpdatedLists","parameters":[{"$ref":"#/components/parameters/AppShort"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list_states":{"type":"array","items":{"type":"object","properties":{"list_id":{"type":"integer","description":"Identifiant de la liste"},"list_updated_since":{"type":"integer","format":"int64","description":"Détecter les modifications de liste depuis ce timestamp"},"access_set_updated_since":{"type":"integer","format":"int64","description":"Détecter les modifications d'autorisation depuis ce timestamp"}}}}}}}}},"responses":{"200":{"description":"Identifiants nécessitant une mise à jour","content":{"application/json":{"schema":{"type":"object","properties":{"lists_to_update":{"type":"array","items":{"type":"integer"}},"lists_with_access_set":{"type":"array","items":{"type":"integer"}},"access_set_to_update":{"type":"array","items":{"type":"integer"}}}}}}}}}}}}
```
## Consulter le statut d'un job asynchrone de liste
> Retourne le statut courant d'un job d'import de liste.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"ListCallbackResponse":{"type":"object","properties":{"callbackDetails":{"type":"object","properties":{"status":{"type":"string","enum":["Planned","Running","Finished","Finished with errors","Failed"],"description":"Statut courant du job"},"nbRecordsTodo":{"type":"integer","description":"Nombre d'éléments à traiter"},"nbRecordsDone":{"type":"integer","description":"Nombre d'éléments déjà traités"},"nbSuccess":{"type":"integer","description":"Nombre d'éléments traités avec succès"},"nbErrors":{"type":"integer","description":"Nombre d'éléments en erreur"},"success":{"type":"array","items":{},"description":"Tableau vide"},"errors":{"type":"array","items":{"type":"string"},"description":"Messages d'erreur"}}}}}}},"paths":{"/{app_short}/lists/callback/{callback_id}":{"get":{"summary":"Consulter le statut d'un job asynchrone de liste","description":"Retourne le statut courant d'un job d'import de liste.","tags":["lists"],"operationId":"getListCallback","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"callback_id","in":"path","required":true,"description":"Identifiant du callback (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Statut du job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCallbackResponse"}}}}}}}}}
```
## Récupérer une liste avec tous ses éléments
> Retourne la liste et tous ses éléments enfants avec pagination.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"ListItemPagedResponse":{"type":"object","properties":{"lists":{"type":"array","items":{"$ref":"#/components/schemas/ListItem"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"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}/lists/{list_id}":{"get":{"summary":"Récupérer une liste avec tous ses éléments","description":"Retourne la liste et tous ses éléments enfants avec pagination.","tags":["lists"],"operationId":"getList","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}},{"name":"per_page","in":"query","description":"Nombre d'éléments par page (maximum 1000)","schema":{"type":"integer","maximum":1000}},{"name":"page","in":"query","description":"Numéro de la page demandée","schema":{"type":"integer"}},{"name":"updated_since","in":"query","description":"Ne retourner que les éléments modifiés après cette date (y compris supprimés)","schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Éléments de liste paginés","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItemPagedResponse"}}}}}}}}}
```
## Supprimer une liste complète
> Supprime définitivement le nœud racine et tous ses enfants. La cible doit être un nœud racine.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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}/lists/{list_id}":{"delete":{"summary":"Supprimer une liste complète","description":"Supprime définitivement le nœud racine et tous ses enfants. La cible doit être un nœud racine.","tags":["lists"],"operationId":"deleteList","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}}],"responses":{"204":{"description":"Liste supprimée"}}}}}}
```
## Modifier le nom d'éléments de liste
> Met à jour le \`name\` d'un ou plusieurs éléments identifiés par leur \`id\`.\
> Envoyez un tableau d'objets \`{id, name}\`.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"ListItemPagedResponse":{"type":"object","properties":{"lists":{"type":"array","items":{"$ref":"#/components/schemas/ListItem"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"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}/lists/{root_id}":{"patch":{"summary":"Modifier le nom d'éléments de liste","description":"Met à jour le `name` d'un ou plusieurs éléments identifiés par leur `id`.\nEnvoyez un tableau d'objets `{id, name}`.\n","tags":["lists"],"operationId":"editListItems","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer","description":"Identifiant de l'élément à modifier"},"name":{"type":"string","description":"Nouveau nom affiché"}}}}}}},"responses":{"200":{"description":"Éléments mis à jour","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItemPagedResponse"}}}}}}}}}
```
## Récupérer les identifiants sélectionnables d'une liste
> Retourne tous les identifiants d'éléments que l'utilisateur authentifié peut sélectionner, selon les autorisations d'accès.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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}/lists/{list_id}/selectables":{"get":{"summary":"Récupérer les identifiants sélectionnables d'une liste","description":"Retourne tous les identifiants d'éléments que l'utilisateur authentifié peut sélectionner, selon les autorisations d'accès.","tags":["lists"],"operationId":"getListSelectables","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"description":"Identifiant de la liste","schema":{"type":"integer"}}],"responses":{"200":{"description":"Identifiants sélectionnables","content":{"application/json":{"schema":{"type":"object","properties":{"selectable_ids":{"type":"array","items":{"type":"integer"}},"server_time":{"type":"integer","format":"int64"}}}}}}}}}}}
```
## POST /{app\_short}/lists/{root\_id}/search
> Rechercher des éléments de liste par identifiant externe
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"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}/lists/{root_id}/search":{"post":{"summary":"Rechercher des éléments de liste par identifiant externe","tags":["lists"],"operationId":"searchListItems","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["external_id"],"properties":{"external_id":{"type":"string","description":"Identifiant externe recherché"}}}}}},"responses":{"200":{"description":"Éléments correspondants","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ListItem"}}}}}}}}}}
```
## Récupérer les enfants directs d'un nœud
> Retourne les enfants de premier niveau du nœud parent indiqué.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"ListItemPagedResponse":{"type":"object","properties":{"lists":{"type":"array","items":{"$ref":"#/components/schemas/ListItem"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"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}/lists/{root_id}/child/{parent_id}":{"get":{"summary":"Récupérer les enfants directs d'un nœud","description":"Retourne les enfants de premier niveau du nœud parent indiqué.","tags":["lists"],"operationId":"getListChildren","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}},{"name":"parent_id","in":"path","required":true,"description":"Identifiant du nœud parent","schema":{"type":"integer"}}],"responses":{"200":{"description":"Éléments enfants directs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItemPagedResponse"}}}}}}}}}
```
## Mettre à jour un élément de liste
> Met à jour les propriétés d'un élément de liste.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"ListItemUpdateRequest":{"type":"object","description":"Corps de mise à jour d'un élément de liste","properties":{"name":{"type":"string","description":"Nom de l'élément"},"latitude":{"type":"number","format":"float","description":"Latitude"},"longitude":{"type":"number","format":"float","description":"Longitude"},"external_id":{"type":"string","description":"Identifiant externe"},"functionnal_status_color":{"type":"string","description":"Couleur de l'élément (hexadécimal)"},"url":{"type":"string","description":"URL de l'élément"}}}}},"paths":{"/{app_short}/lists/{root_id}/{list_id}":{"put":{"summary":"Mettre à jour un élément de liste","description":"Met à jour les propriétés d'un élément de liste.","tags":["lists"],"operationId":"updateListItem","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}},{"name":"list_id","in":"path","required":true,"description":"Identifiant de l'élément de liste","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItemUpdateRequest"}}}},"responses":{"200":{"description":"Élément mis à jour","content":{"application/json":{"schema":{"type":"array","items":{}}}}}}}}}}
```
## Supprimer un élément de liste
> Supprime l'élément et tous ses enfants de manière récursive.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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}/lists/{root_id}/{list_id}":{"delete":{"summary":"Supprimer un élément de liste","description":"Supprime l'élément et tous ses enfants de manière récursive.","tags":["lists"],"operationId":"deleteListItem","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}},{"name":"list_id","in":"path","required":true,"description":"Identifiant de l'élément de liste","schema":{"type":"integer"}}],"responses":{"204":{"description":"Élément supprimé"}}}}}}
```
## Ajouter des enfants en masse à un nœud
> Ajoute plusieurs éléments enfants à un nœud parent en une seule requête.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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":{"ListItemUpdateRequest":{"type":"object","description":"Corps de mise à jour d'un élément de liste","properties":{"name":{"type":"string","description":"Nom de l'élément"},"latitude":{"type":"number","format":"float","description":"Latitude"},"longitude":{"type":"number","format":"float","description":"Longitude"},"external_id":{"type":"string","description":"Identifiant externe"},"functionnal_status_color":{"type":"string","description":"Couleur de l'élément (hexadécimal)"},"url":{"type":"string","description":"URL de l'élément"}}}}},"paths":{"/{app_short}/lists/{root_id}/{list_id}":{"patch":{"summary":"Ajouter des enfants en masse à un nœud","description":"Ajoute plusieurs éléments enfants à un nœud parent en une seule requête.","tags":["lists"],"operationId":"addListChildren","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}},{"name":"list_id","in":"path","required":true,"description":"Identifiant du nœud parent","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ListItemUpdateRequest"}}}}},"responses":{"200":{"description":"Enfants ajoutés","content":{"application/json":{"schema":{"type":"array","items":{}}}}}}}}}}
```
## Récupérer l'image d'un élément de liste
> Retourne l'image de l'élément — uniquement si \`has\_image\` est \`true\`.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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}/lists/{root_id}/{list_id}/image":{"get":{"summary":"Récupérer l'image d'un élément de liste","description":"Retourne l'image de l'élément — uniquement si `has_image` est `true`.","tags":["lists"],"operationId":"getListItemImage","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant du nœud racine","schema":{"type":"integer"}},{"name":"list_id","in":"path","required":true,"description":"Identifiant de l'élément de liste","schema":{"type":"integer"}}],"responses":{"200":{"description":"Contenu de l'image","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}}}}}}}
```
## Changer la position d'un nœud
> Déplace un nœud par rapport à un nœud de référence.\
> \
> \| \`direction\` | Effet |\
> \|---|---|\
> \| \`child\` | Devient le premier enfant du nœud de référence |\
> \| \`before\` | Positionné juste avant le nœud de référence (même parent) |\
> \| \`after\` | Positionné juste après le nœud de référence (même parent) |
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"lists"}],"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}/lists/{root_id}/{node_to_move_id}/{direction}/{node_position_id}":{"put":{"summary":"Changer la position d'un nœud","description":"Déplace un nœud par rapport à un nœud de référence.\n\n| `direction` | Effet |\n|---|---|\n| `child` | Devient le premier enfant du nœud de référence |\n| `before` | Positionné juste avant le nœud de référence (même parent) |\n| `after` | Positionné juste après le nœud de référence (même parent) |\n","tags":["lists"],"operationId":"moveListNode","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Identifiant racine de la liste à modifier","schema":{"type":"integer"}},{"name":"node_to_move_id","in":"path","required":true,"description":"Identifiant du nœud à déplacer","schema":{"type":"integer"}},{"name":"direction","in":"path","required":true,"description":"Direction de placement par rapport au nœud de référence","schema":{"type":"string","enum":["child","before","after"]}},{"name":"node_position_id","in":"path","required":true,"description":"Identifiant du nœud de référence","schema":{"type":"integer"}}],"responses":{"200":{"description":"Nœud repositionné"}}}}}}
```
---
# 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.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.