# Lists
## List all lists (root IDs only)
> Returns all root list identifiers in the workspace without their child 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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"ListPagedResponse":{"type":"object","properties":{"lists":{"type":"array","items":{"type":"object","properties":{"root_id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"list_last_updated":{"type":"integer","format":"int64"}}}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}}}},"paths":{"/{app_short}/lists":{"get":{"summary":"List all lists (root IDs only)","description":"Returns all root list identifiers in the workspace without their child items.","tags":["lists"],"operationId":"listLists","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"per_page","in":"query","schema":{"type":"integer","default":10,"maximum":1000}},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"updated_since","in":"query","description":"Return only lists updated after this date (including deleted ones)","schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Paginated root list entries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListPagedResponse"}}}}}}}}}
```
## Create a list
> Creates a root node with optional hierarchical children 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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"ListCreateRequest":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"external_id":{"type":"string"},"items":{"type":"array","description":"Nested child items (recursive)","items":{"$ref":"#/components/schemas/ListCreateRequest"}}}},"ListItem":{"type":"object","properties":{"id":{"type":"integer"},"root_id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"deleted_at":{"type":"integer","format":"int64","nullable":true},"name":{"type":"string"},"has_image":{"type":"boolean"},"level":{"type":"integer","description":"Depth — 0 is the root node"},"position":{"type":"integer"},"external_id":{"type":"string"},"url":{"type":"string"},"functionnal_status_color":{"type":"string"}}}}},"paths":{"/{app_short}/lists":{"post":{"summary":"Create a list","description":"Creates a root node with optional hierarchical children 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":"Root list node created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItem"}}}}}}}}}
```
## Import a list from CSV (async)
> Imports or diffs list data from a previously uploaded CSV file.\
> Poll the returned \`callbackUrl\` for status.
```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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"CallbackUrlResponse":{"type":"object","properties":{"callbackUrl":{"type":"string","description":"URL to poll for async job status"}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Unique error code prefixed with `DAERR-`"},"message":{"type":"string"},"url":{"type":"string","format":"uri","description":"Link to the detailed error documentation"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Additional context (may be empty)"},"server_time":{"type":"string","description":"Unix timestamp as string"}}}}},"paths":{"/{app_short}/lists/import":{"post":{"summary":"Import a list from CSV (async)","description":"Imports or diffs list data from a previously uploaded CSV file.\nPoll the returned `callbackUrl` for status.\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"},"file_id":{"type":"string","format":"uuid"},"separator":{"type":"string","default":";"},"mode":{"type":"string","enum":["APPEND","DIFF"]},"encoding":{"type":"string","enum":["UTF-8","WINDOWS-1252","WINDOWS-1256"],"default":"UTF-8"}}}}}},"responses":{"200":{"description":"Async job accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackUrlResponse"}}}},"400":{"description":"Validation error (missing file_id, bad encoding, file not found, etc.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Get modified list and access-set IDs
> Returns IDs of lists and access sets that have changed and need syncing.
```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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}}},"paths":{"/{app_short}/lists/updated":{"post":{"summary":"Get modified list and access-set IDs","description":"Returns IDs of lists and access sets that have changed and need syncing.","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"},"list_updated_since":{"type":"integer","format":"int64"},"access_set_updated_since":{"type":"integer","format":"int64"}}}}}}}}},"responses":{"200":{"description":"IDs of lists and access sets requiring an update","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"}}}}}}}}}}}}
```
## GET /{app\_short}/lists/callback/{callback\_id}
> Poll async list job status
```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":"Short name of the workspace instance (e.g. `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"]},"nbRecordsTodo":{"type":"integer"},"nbRecordsDone":{"type":"integer"},"nbSuccess":{"type":"integer"},"nbErrors":{"type":"integer"},"success":{"type":"array","items":{}},"errors":{"type":"array","items":{"type":"string"}}}}}}}},"paths":{"/{app_short}/lists/callback/{callback_id}":{"get":{"summary":"Poll async list job status","tags":["lists"],"operationId":"getListCallback","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"callback_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Job status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCallbackResponse"}}}}}}}}}
```
## Get a list with all its items
> Returns the list and all child items with 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":"Short name of the workspace instance (e.g. `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","properties":{"id":{"type":"integer"},"root_id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"deleted_at":{"type":"integer","format":"int64","nullable":true},"name":{"type":"string"},"has_image":{"type":"boolean"},"level":{"type":"integer","description":"Depth — 0 is the root node"},"position":{"type":"integer"},"external_id":{"type":"string"},"url":{"type":"string"},"functionnal_status_color":{"type":"string"}}}}},"paths":{"/{app_short}/lists/{list_id}":{"get":{"summary":"Get a list with all its items","description":"Returns the list and all child items with pagination.","tags":["lists"],"operationId":"getList","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"per_page","in":"query","schema":{"type":"integer","maximum":1000}},{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"updated_since","in":"query","description":"Return only items updated after this date (including deleted ones)","schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Paginated list items","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItemPagedResponse"}}}}}}}}}
```
## Delete a complete list
> Permanently removes the root node and all children. Target must be a root node.
```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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}}},"paths":{"/{app_short}/lists/{list_id}":{"delete":{"summary":"Delete a complete list","description":"Permanently removes the root node and all children. Target must be a root node.","tags":["lists"],"operationId":"deleteList","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"List deleted"}}}}}}
```
## Edit list item names
> Updates the \`name\` of one or more items identified by their \`id\`.\
> Send an array of \`{id, name}\` objects.
```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":"Short name of the workspace instance (e.g. `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","properties":{"id":{"type":"integer"},"root_id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"deleted_at":{"type":"integer","format":"int64","nullable":true},"name":{"type":"string"},"has_image":{"type":"boolean"},"level":{"type":"integer","description":"Depth — 0 is the root node"},"position":{"type":"integer"},"external_id":{"type":"string"},"url":{"type":"string"},"functionnal_status_color":{"type":"string"}}}}},"paths":{"/{app_short}/lists/{root_id}":{"patch":{"summary":"Edit list item names","description":"Updates the `name` of one or more items identified by their `id`.\nSend an array of `{id, name}` objects.\n","tags":["lists"],"operationId":"editListItems","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"description":"Root node identifier","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}},"responses":{"200":{"description":"Updated items","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItemPagedResponse"}}}}}}}}}
```
## Get selectable item IDs for a list
> Returns all item IDs the authenticated user can select, respecting access sets.
```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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}}},"paths":{"/{app_short}/lists/{list_id}/selectables":{"get":{"summary":"Get selectable item IDs for a list","description":"Returns all item IDs the authenticated user can select, respecting access sets.","tags":["lists"],"operationId":"getListSelectables","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"list_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Selectable item IDs","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
> Search list items by external\_id
```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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"ListItem":{"type":"object","properties":{"id":{"type":"integer"},"root_id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"deleted_at":{"type":"integer","format":"int64","nullable":true},"name":{"type":"string"},"has_image":{"type":"boolean"},"level":{"type":"integer","description":"Depth — 0 is the root node"},"position":{"type":"integer"},"external_id":{"type":"string"},"url":{"type":"string"},"functionnal_status_color":{"type":"string"}}}}},"paths":{"/{app_short}/lists/{root_id}/search":{"post":{"summary":"Search list items by external_id","tags":["lists"],"operationId":"searchListItems","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["external_id"],"properties":{"external_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Matching list items","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ListItem"}}}}}}}}}}
```
## GET /{app\_short}/lists/{root\_id}/child/{parent\_id}
> Get direct children of a node
```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":"Short name of the workspace instance (e.g. `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","properties":{"id":{"type":"integer"},"root_id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"deleted_at":{"type":"integer","format":"int64","nullable":true},"name":{"type":"string"},"has_image":{"type":"boolean"},"level":{"type":"integer","description":"Depth — 0 is the root node"},"position":{"type":"integer"},"external_id":{"type":"string"},"url":{"type":"string"},"functionnal_status_color":{"type":"string"}}}}},"paths":{"/{app_short}/lists/{root_id}/child/{parent_id}":{"get":{"summary":"Get direct children of a node","tags":["lists"],"operationId":"getListChildren","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"parent_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Direct child items","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItemPagedResponse"}}}}}}}}}
```
## PUT /{app\_short}/lists/{root\_id}/{list\_id}
> Update a list item
```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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"ListItemUpdateRequest":{"type":"object","properties":{"name":{"type":"string"},"latitude":{"type":"number","format":"float"},"longitude":{"type":"number","format":"float"},"external_id":{"type":"string"},"functionnal_status_color":{"type":"string"},"url":{"type":"string"}}}}},"paths":{"/{app_short}/lists/{root_id}/{list_id}":{"put":{"summary":"Update a list item","tags":["lists"],"operationId":"updateListItem","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"list_id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListItemUpdateRequest"}}}},"responses":{"200":{"description":"Item updated","content":{"application/json":{"schema":{"type":"array","items":{}}}}}}}}}}
```
## Delete a list item
> Removes the item and all its children recursively.
```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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}}},"paths":{"/{app_short}/lists/{root_id}/{list_id}":{"delete":{"summary":"Delete a list item","description":"Removes the item and all its children recursively.","tags":["lists"],"operationId":"deleteListItem","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"list_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Item deleted"}}}}}}
```
## Bulk add children to a node
> Appends multiple children to a parent node in one request.
```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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"ListItemUpdateRequest":{"type":"object","properties":{"name":{"type":"string"},"latitude":{"type":"number","format":"float"},"longitude":{"type":"number","format":"float"},"external_id":{"type":"string"},"functionnal_status_color":{"type":"string"},"url":{"type":"string"}}}}},"paths":{"/{app_short}/lists/{root_id}/{list_id}":{"patch":{"summary":"Bulk add children to a node","description":"Appends multiple children to a parent node in one request.","tags":["lists"],"operationId":"addListChildren","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"list_id","in":"path","required":true,"description":"Parent node identifier","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ListItemUpdateRequest"}}}}},"responses":{"200":{"description":"Children added","content":{"application/json":{"schema":{"type":"array","items":{}}}}}}}}}}
```
## Get the image for a list item
> Returns the image — only when \`has\_image\` is \`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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}}},"paths":{"/{app_short}/lists/{root_id}/{list_id}/image":{"get":{"summary":"Get the image for a list item","description":"Returns the image — only when `has_image` is `true`.","tags":["lists"],"operationId":"getListItemImage","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"list_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Image content","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}}}}}}}
```
## Reposition a list node
> Moves a node relative to a reference node.\
> \
> \| \`direction\` | Effect |\
> \|---|---|\
> \| \`child\` | Becomes the first child of the reference node |\
> \| \`before\` | Placed just before the reference node (same parent) |\
> \| \`after\` | Placed just after the reference node (same 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":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}}},"paths":{"/{app_short}/lists/{root_id}/{node_to_move_id}/{direction}/{node_position_id}":{"put":{"summary":"Reposition a list node","description":"Moves a node relative to a reference node.\n\n| `direction` | Effect |\n|---|---|\n| `child` | Becomes the first child of the reference node |\n| `before` | Placed just before the reference node (same parent) |\n| `after` | Placed just after the reference node (same parent) |\n","tags":["lists"],"operationId":"moveListNode","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"root_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"node_to_move_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"direction","in":"path","required":true,"schema":{"type":"string","enum":["child","before","after"]}},{"name":"node_position_id","in":"path","required":true,"description":"Reference node for placement","schema":{"type":"integer"}}],"responses":{"200":{"description":"Node repositioned"}}}}}}
```
---
# 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/lists.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.