# Models

## The ErrorResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"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"}}}}}}
```

## The PasswordGrantRequest object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"PasswordGrantRequest":{"type":"object","required":["client_id","client_secret","grant_type","username","password"],"properties":{"client_id":{"type":"string"},"client_secret":{"type":"string"},"grant_type":{"type":"string","enum":["password"]},"username":{"type":"string","format":"email"},"password":{"type":"string","format":"password"}}}}}}
```

## The RefreshTokenGrantRequest object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"RefreshTokenGrantRequest":{"type":"object","required":["client_id","client_secret","grant_type","refresh_token"],"properties":{"client_id":{"type":"string"},"client_secret":{"type":"string"},"grant_type":{"type":"string","enum":["refresh_token"]},"refresh_token":{"type":"string"}}}}}}
```

## The TokenResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"TokenResponse":{"type":"object","properties":{"access_token":{"type":"string"},"refresh_token":{"type":"string"},"expires_in":{"type":"integer","description":"Validity in seconds (3600)"},"token_type":{"type":"string"},"scope":{"type":"string"}}}}}}
```

## The App object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"App":{"type":"object","properties":{"name":{"type":"string"},"short":{"type":"string","description":"Use this as the `{app_short}` prefix in subsequent API calls"},"description":{"type":"string"},"settings":{"type":"object","additionalProperties":true},"android_map":{"type":"boolean"},"is_model":{"type":"boolean"}}}}}}
```

## The FileUploadResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"FileUploadResponse":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid","description":"Reference this UUID in submission fields of type image/signature/file"},"mime-type":{"type":"string"},"size":{"type":"integer","description":"File size in bytes"}}}}}}
```

## The Structure object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Structure":{"type":"object","properties":{"id":{"type":"integer"},"version":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"settings":{"type":"object","additionalProperties":true},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Field"}},"layout":{"type":"object","properties":{"pages":{"type":"array","items":{}},"fields":{"type":"array","items":{}}}},"workflows":{"type":"array","items":{"$ref":"#/components/schemas/Workflow"}},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/Trigger"}}}},"Condition":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"cdt":{"type":"string","description":"JavaScript condition expression"},"fields":{"type":"array","items":{"type":"string"}},"json_format":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"type":"string"},"operator":{"type":"string"}}}}}},"Field":{"type":"object","properties":{"name":{"type":"string","description":"System name — used as key in submission `items`"},"label":{"type":"string"},"position":{"type":"integer"},"type":{"type":"string","description":"text, number, boolean, date, duration, phone, email, location, image, signature, file, list, relation, user, label…\n"},"enable":{"type":"boolean"},"required":{"type":"boolean"},"prefill":{"type":"boolean"},"readonly":{"type":"boolean"},"searchable":{"type":"boolean"}}},"Workflow":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"start_state":{"type":"string","format":"uuid"},"states":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowState"}},"transitions":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowTransition"}}}},"WorkflowState":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"color":{"type":"string"},"end":{"type":"boolean","description":"Submissions in end states cannot be modified"}}},"WorkflowTransition":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"from":{"type":"string","format":"uuid"},"to":{"type":"string","format":"uuid"},"label":{"type":"string"}}},"Trigger":{"type":"object","description":"Customises how a workflow transition appears as a save button","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string"},"transition_id":{"type":"string","format":"uuid"},"color":{"type":"string"},"label":{"type":"string"}}}}}}
```

## The StructureListResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"StructureListResponse":{"type":"object","properties":{"structures":{"type":"array","items":{"$ref":"#/components/schemas/Structure"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"},"workflows":{"type":"array","items":{"$ref":"#/components/schemas/Workflow"}},"required":{"type":"object","properties":{"linked_list_ids":{"type":"array","items":{"type":"integer"}},"structure_ids":{"type":"array","items":{"type":"integer"}}}}}},"Structure":{"type":"object","properties":{"id":{"type":"integer"},"version":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"settings":{"type":"object","additionalProperties":true},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Field"}},"layout":{"type":"object","properties":{"pages":{"type":"array","items":{}},"fields":{"type":"array","items":{}}}},"workflows":{"type":"array","items":{"$ref":"#/components/schemas/Workflow"}},"triggers":{"type":"array","items":{"$ref":"#/components/schemas/Trigger"}}}},"Condition":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"cdt":{"type":"string","description":"JavaScript condition expression"},"fields":{"type":"array","items":{"type":"string"}},"json_format":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"type":"string"},"operator":{"type":"string"}}}}}},"Field":{"type":"object","properties":{"name":{"type":"string","description":"System name — used as key in submission `items`"},"label":{"type":"string"},"position":{"type":"integer"},"type":{"type":"string","description":"text, number, boolean, date, duration, phone, email, location, image, signature, file, list, relation, user, label…\n"},"enable":{"type":"boolean"},"required":{"type":"boolean"},"prefill":{"type":"boolean"},"readonly":{"type":"boolean"},"searchable":{"type":"boolean"}}},"Workflow":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"start_state":{"type":"string","format":"uuid"},"states":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowState"}},"transitions":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowTransition"}}}},"WorkflowState":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"color":{"type":"string"},"end":{"type":"boolean","description":"Submissions in end states cannot be modified"}}},"WorkflowTransition":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"from":{"type":"string","format":"uuid"},"to":{"type":"string","format":"uuid"},"label":{"type":"string"}}},"Trigger":{"type":"object","description":"Customises how a workflow transition appears as a save button","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string"},"transition_id":{"type":"string","format":"uuid"},"color":{"type":"string"},"label":{"type":"string"}}}}}}
```

## The Field object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Field":{"type":"object","properties":{"name":{"type":"string","description":"System name — used as key in submission `items`"},"label":{"type":"string"},"position":{"type":"integer"},"type":{"type":"string","description":"text, number, boolean, date, duration, phone, email, location, image, signature, file, list, relation, user, label…\n"},"enable":{"type":"boolean"},"required":{"type":"boolean"},"prefill":{"type":"boolean"},"readonly":{"type":"boolean"},"searchable":{"type":"boolean"}}}}}}
```

## The Condition object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Condition":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"cdt":{"type":"string","description":"JavaScript condition expression"},"fields":{"type":"array","items":{"type":"string"}},"json_format":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"type":"string"},"operator":{"type":"string"}}}}}}}}}
```

## The Workflow object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Workflow":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"start_state":{"type":"string","format":"uuid"},"states":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowState"}},"transitions":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowTransition"}}}},"WorkflowState":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"color":{"type":"string"},"end":{"type":"boolean","description":"Submissions in end states cannot be modified"}}},"WorkflowTransition":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"from":{"type":"string","format":"uuid"},"to":{"type":"string","format":"uuid"},"label":{"type":"string"}}}}}}
```

## The WorkflowState object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"WorkflowState":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"color":{"type":"string"},"end":{"type":"boolean","description":"Submissions in end states cannot be modified"}}}}}}
```

## The WorkflowTransition object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"WorkflowTransition":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"from":{"type":"string","format":"uuid"},"to":{"type":"string","format":"uuid"},"label":{"type":"string"}}}}}}
```

## The Trigger object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Trigger":{"type":"object","description":"Customises how a workflow transition appears as a save button","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string"},"transition_id":{"type":"string","format":"uuid"},"color":{"type":"string"},"label":{"type":"string"}}}}}}
```

## The StructureRelationPagedResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"StructureRelationPagedResponse":{"type":"object","properties":{"structure_relations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}}}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}}}}}
```

## The SubmissionRelationPagedResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"SubmissionRelationPagedResponse":{"type":"object","properties":{"submission_relations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}}}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}}}}}
```

## The Submission object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Submission":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"data_created_at":{"type":"integer","format":"int64"},"data_updated_at":{"type":"integer","format":"int64"},"user_id":{"type":"integer"},"channels":{"type":"array","items":{"type":"string"}},"items":{"type":"object","additionalProperties":true,"description":"Key/value map keyed by system field name.\n\n**Simple:** text/email → string | number → float | boolean → bool |\ndate → Unix timestamp | duration → ms | phone → RFC 3966\n\n**location:** `{lat, lng, address}`\n\n**image/signature/file:** `[{id, name, mimeType, extension, size, comment}]`\n\n**list:** `[id, …]`\n\n**relation:** `{submissions: [{id, count?}, …]}`\n\n**user:** `[{id}, …]`\n"},"submission_number":{"type":"integer"},"number_in_structure":{"type":"integer"},"latitude":{"type":"number","format":"double"},"longitude":{"type":"number","format":"double"},"last_updated_user_id":{"type":"integer"},"current_state":{"type":"string","format":"uuid","nullable":true,"description":"Current workflow state UUID"},"assigned_user":{"$ref":"#/components/schemas/UserRef"},"subscribers":{"type":"array","items":{}},"settings":{"type":"array","items":{}}}},"UserRef":{"type":"object","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"first_name":{"type":"string"},"last_name":{"type":"string"},"groups":{"type":"array","items":{}},"system_groups":{"type":"array","items":{}}}}}}}
```

## The SubmissionInput object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"SubmissionInput":{"type":"object","required":["structure_id","structure_version","items"],"properties":{"id":{"type":"string","format":"uuid","description":"Auto-generated if omitted"},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"created_at":{"type":"integer","format":"int64","description":"Defaults to now"},"updated_at":{"type":"integer","format":"int64","description":"Defaults to now"},"trigger_id":{"type":"string","format":"uuid","description":"Workflow transition to apply (PUT/PATCH only)"},"substitute_user_id":{"type":"integer","description":"Sets a different user as creator/owner; authenticated user is always traced in history"},"items":{"type":"object","additionalProperties":true}}}}}}
```

## The SubmissionListResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"SubmissionListResponse":{"type":"object","properties":{"submissions":{"type":"array","items":{"$ref":"#/components/schemas/Submission"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"Submission":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"data_created_at":{"type":"integer","format":"int64"},"data_updated_at":{"type":"integer","format":"int64"},"user_id":{"type":"integer"},"channels":{"type":"array","items":{"type":"string"}},"items":{"type":"object","additionalProperties":true,"description":"Key/value map keyed by system field name.\n\n**Simple:** text/email → string | number → float | boolean → bool |\ndate → Unix timestamp | duration → ms | phone → RFC 3966\n\n**location:** `{lat, lng, address}`\n\n**image/signature/file:** `[{id, name, mimeType, extension, size, comment}]`\n\n**list:** `[id, …]`\n\n**relation:** `{submissions: [{id, count?}, …]}`\n\n**user:** `[{id}, …]`\n"},"submission_number":{"type":"integer"},"number_in_structure":{"type":"integer"},"latitude":{"type":"number","format":"double"},"longitude":{"type":"number","format":"double"},"last_updated_user_id":{"type":"integer"},"current_state":{"type":"string","format":"uuid","nullable":true,"description":"Current workflow state UUID"},"assigned_user":{"$ref":"#/components/schemas/UserRef"},"subscribers":{"type":"array","items":{}},"settings":{"type":"array","items":{}}}},"UserRef":{"type":"object","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"first_name":{"type":"string"},"last_name":{"type":"string"},"groups":{"type":"array","items":{}},"system_groups":{"type":"array","items":{}}}}}}}
```

## The SearchCriteria object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"SearchCriteria":{"type":"object","additionalProperties":{"type":"object","required":["operator"],"properties":{"value":{"description":"Search value (omit for isNull / isNotNull)"},"operator":{"type":"string","enum":["equal","notequal","isNull","isNotNull","less","greater","lesseq","greatereq","contains","notContains","startWith","endWith","in","range"]}}},"description":"Object where each key is a valid system field name"}}}}
```

## The CallbackUrlResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"CallbackUrlResponse":{"type":"object","properties":{"callbackUrl":{"type":"string","description":"URL to poll for async job status"}}}}}}
```

## The SubmissionCallbackResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"SubmissionCallbackResponse":{"type":"object","properties":{"callbackDetails":{"type":"object","properties":{"status":{"type":"string","enum":["Planned","Running","Finished","Finished with errors","Failed","In timeout"]},"nbRecordsTodo":{"type":"integer"},"nbRecordsDone":{"type":"integer"},"nbSuccess":{"type":"integer"},"nbErrors":{"type":"integer"},"success":{"type":"array","items":{"type":"string","format":"uuid"}},"errors":{"type":"array","items":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}}}}}}}
```

## The UserRef object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"UserRef":{"type":"object","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"first_name":{"type":"string"},"last_name":{"type":"string"},"groups":{"type":"array","items":{}},"system_groups":{"type":"array","items":{}}}}}}}
```

## The Comment object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Comment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment identifier (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML or script tags"},"client_created_at":{"type":"integer","format":"int64","description":"Client-side creation timestamp (Unix timestamp)"},"client_updated_at":{"type":"integer","format":"int64","description":"Client-side update timestamp (Unix timestamp)"},"user_id":{"type":"integer"},"submission_id":{"type":"string","format":"uuid"},"replies":{"type":"array","description":"Second-level replies (thread depth is limited to 2)","items":{"$ref":"#/components/schemas/Comment"}}}}}}}
```

## The CommentInput object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"CommentInput":{"type":"object","required":["message"],"properties":{"id":{"type":"string","format":"uuid","description":"Optional client-supplied UUID v4"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML, script tags, or dangerous characters"},"client_created_at":{"type":"integer","format":"int64","description":"Unix timestamp"},"client_updated_at":{"type":"integer","format":"int64","description":"Unix timestamp"}}}}}}
```

## The CustomAppSummary object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"CustomAppSummary":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"}}}}}}
```

## The CustomApp object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"CustomApp":{"allOf":[{"$ref":"#/components/schemas/CustomAppSummary"},{"type":"object","properties":{"banner":{"type":"object","additionalProperties":true},"splash":{"type":"object","properties":{"active":{"type":"boolean"},"image":{"type":"string","description":"Image file UUID"},"color":{"type":"string"},"aspect":{"type":"string","enum":["fit","fill"]},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"}}},"menus":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"target":{"type":"string"},"label":{"type":"object","additionalProperties":{"type":"string"},"description":"Localised labels keyed by locale (e.g. `fr`, `en`)"},"icon":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"}}},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"}}}},"screens":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"pages":{"type":"array","items":{"type":"object","properties":{"system_name":{"type":"string"},"title":{"type":"object","additionalProperties":{"type":"string"}},"side_menu":{"type":"boolean"},"widgets":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"index":{"type":"integer"},"label":{"type":"object","additionalProperties":{"type":"string"}},"color":{"type":"string"},"target":{"type":"string"},"icon":{"type":"object","additionalProperties":true},"background":{"type":"string","description":"Background image UUID (full button type)"}}}},"layout":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer"},"y":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}}}}}},"settings":{"type":"array","items":{}},"groups":{"type":"array","items":{}},"widget_spacing":{"type":"integer","enum":[0,1],"description":"`0` = flat mode, `1` = standard"},"button_type":{"type":"string","enum":["standard","mix","full"],"description":"`standard` = Font Awesome icon, `mix` = image icon, `full` = background image"},"label_overlay":{"type":"boolean"},"grant_all":{"type":"boolean"}}}]},"CustomAppSummary":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"}}}}}}
```

## The ListItem object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"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"}}}}}}
```

## The ListPagedResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"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"}}}}}}
```

## The ListItemPagedResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"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"}}}}}}
```

## The ListCreateRequest object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"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"}}}}}}}
```

## The ListItemUpdateRequest object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"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"}}}}}}
```

## The ListCallbackResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"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"}}}}}}}}}
```

## The ListAccessSetSummary object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"ListAccessSetSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"users":{"type":"array","items":{"type":"string"}},"groups":{"type":"array","items":{}},"root_id":{"type":"integer"},"lists":{"type":"array","items":{"type":"integer"}}}}}}}
```

## The ListAccessSetDetail object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"ListAccessSetDetail":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserRef"}},"groups":{"type":"array","items":{}},"root_id":{"type":"object","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"}}}},"UserRef":{"type":"object","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"first_name":{"type":"string"},"last_name":{"type":"string"},"groups":{"type":"array","items":{}},"system_groups":{"type":"array","items":{}}}},"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"}}}}}}
```

## The Task object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Task":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"start_date":{"type":"integer","format":"int64","description":"Planned start date (Unix timestamp)"},"due_date":{"type":"integer","format":"int64","description":"Due date (Unix timestamp)"},"duration":{"type":"integer","description":"Expected duration in seconds"},"delay_before":{"type":"integer","description":"Indicative display delay in seconds before the task begins"},"delay_after":{"type":"integer","description":"Indicative display delay in seconds after task completion time"},"user_id":{"type":"integer"},"submission":{"$ref":"#/components/schemas/Submission"}}},"Submission":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"data_created_at":{"type":"integer","format":"int64"},"data_updated_at":{"type":"integer","format":"int64"},"user_id":{"type":"integer"},"channels":{"type":"array","items":{"type":"string"}},"items":{"type":"object","additionalProperties":true,"description":"Key/value map keyed by system field name.\n\n**Simple:** text/email → string | number → float | boolean → bool |\ndate → Unix timestamp | duration → ms | phone → RFC 3966\n\n**location:** `{lat, lng, address}`\n\n**image/signature/file:** `[{id, name, mimeType, extension, size, comment}]`\n\n**list:** `[id, …]`\n\n**relation:** `{submissions: [{id, count?}, …]}`\n\n**user:** `[{id}, …]`\n"},"submission_number":{"type":"integer"},"number_in_structure":{"type":"integer"},"latitude":{"type":"number","format":"double"},"longitude":{"type":"number","format":"double"},"last_updated_user_id":{"type":"integer"},"current_state":{"type":"string","format":"uuid","nullable":true,"description":"Current workflow state UUID"},"assigned_user":{"$ref":"#/components/schemas/UserRef"},"subscribers":{"type":"array","items":{}},"settings":{"type":"array","items":{}}}},"UserRef":{"type":"object","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"first_name":{"type":"string"},"last_name":{"type":"string"},"groups":{"type":"array","items":{}},"system_groups":{"type":"array","items":{}}}}}}}
```

## The TaskListResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"TaskListResponse":{"type":"object","properties":{"tasks":{"type":"array","items":{"$ref":"#/components/schemas/Task"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"Task":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"start_date":{"type":"integer","format":"int64","description":"Planned start date (Unix timestamp)"},"due_date":{"type":"integer","format":"int64","description":"Due date (Unix timestamp)"},"duration":{"type":"integer","description":"Expected duration in seconds"},"delay_before":{"type":"integer","description":"Indicative display delay in seconds before the task begins"},"delay_after":{"type":"integer","description":"Indicative display delay in seconds after task completion time"},"user_id":{"type":"integer"},"submission":{"$ref":"#/components/schemas/Submission"}}},"Submission":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"type":"integer"},"structure_version":{"type":"integer"},"created_at":{"type":"integer","format":"int64"},"updated_at":{"type":"integer","format":"int64"},"data_created_at":{"type":"integer","format":"int64"},"data_updated_at":{"type":"integer","format":"int64"},"user_id":{"type":"integer"},"channels":{"type":"array","items":{"type":"string"}},"items":{"type":"object","additionalProperties":true,"description":"Key/value map keyed by system field name.\n\n**Simple:** text/email → string | number → float | boolean → bool |\ndate → Unix timestamp | duration → ms | phone → RFC 3966\n\n**location:** `{lat, lng, address}`\n\n**image/signature/file:** `[{id, name, mimeType, extension, size, comment}]`\n\n**list:** `[id, …]`\n\n**relation:** `{submissions: [{id, count?}, …]}`\n\n**user:** `[{id}, …]`\n"},"submission_number":{"type":"integer"},"number_in_structure":{"type":"integer"},"latitude":{"type":"number","format":"double"},"longitude":{"type":"number","format":"double"},"last_updated_user_id":{"type":"integer"},"current_state":{"type":"string","format":"uuid","nullable":true,"description":"Current workflow state UUID"},"assigned_user":{"$ref":"#/components/schemas/UserRef"},"subscribers":{"type":"array","items":{}},"settings":{"type":"array","items":{}}}},"UserRef":{"type":"object","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"first_name":{"type":"string"},"last_name":{"type":"string"},"groups":{"type":"array","items":{}},"system_groups":{"type":"array","items":{}}}}}}}
```


---

# 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/models.md?ask=<question>
```

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.