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

# 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":{}}}}}}}
```

## The TaskInput object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"TaskInput":{"type":"object","required":["start_date"],"description":"Body for creating a task. Provide either `submission_model_id` or `submissions`.\nAdd `recurrency` for a recurring task (in which case `due_date` is optional).\n","properties":{"start_date":{"type":"integer","format":"int64","description":"Task start date (UNIX timestamp)"},"due_date":{"type":"integer","format":"int64","description":"Due date (UNIX timestamp). Optional for a recurring task."},"submission_model_id":{"type":"string","format":"uuid","description":"Identifier of a submission model"},"submissions":{"type":"array","description":"List of submission identifiers","items":{"type":"string","format":"uuid"}},"user_id":{"type":"integer","nullable":true,"description":"Identifier of the assigned user"},"duration":{"type":"integer","description":"Task 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 the task's due time"},"recurrency":{"$ref":"#/components/schemas/Recurrency"}}},"Recurrency":{"type":"object","description":"Recurrence definition for a task","properties":{"type":{"type":"string","enum":["daily","weekly"],"description":"Recurrence type"},"interval":{"type":"integer","description":"Interval between each occurrence (minimum 1)"},"days":{"type":"object","description":"Days of the week (first 3 letters in English: mon, tue, wed, thu, fri, sat, sun).\nFor weekly recurrence, not all days are required.\n","additionalProperties":{"type":"object","properties":{"start":{"type":"string","description":"Start time (HH:MM format)"},"end":{"type":"integer","description":"Task duration in seconds"}}}},"end":{"type":"object","description":"Recurrence end condition","properties":{"type":{"type":"string","enum":["occurrence","date"],"description":"`occurrence` = number of occurrences, `date` = end date"},"value":{"type":"integer","description":"Number of occurrences or end date (timestamp) depending on `type`"}}}}}}}}
```

## The Recurrency object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Recurrency":{"type":"object","description":"Recurrence definition for a task","properties":{"type":{"type":"string","enum":["daily","weekly"],"description":"Recurrence type"},"interval":{"type":"integer","description":"Interval between each occurrence (minimum 1)"},"days":{"type":"object","description":"Days of the week (first 3 letters in English: mon, tue, wed, thu, fri, sat, sun).\nFor weekly recurrence, not all days are required.\n","additionalProperties":{"type":"object","properties":{"start":{"type":"string","description":"Start time (HH:MM format)"},"end":{"type":"integer","description":"Task duration in seconds"}}}},"end":{"type":"object","description":"Recurrence end condition","properties":{"type":{"type":"string","enum":["occurrence","date"],"description":"`occurrence` = number of occurrences, `date` = end date"},"value":{"type":"integer","description":"Number of occurrences or end date (timestamp) depending on `type`"}}}}}}}}
```

## The ReportTemplate object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"ReportTemplate":{"type":"object","description":"Mail-merge template","properties":{"id":{"type":"integer","description":"Template identifier"},"name":{"type":"string","description":"Template name"},"listingMode":{"type":"boolean","description":"Whether the template is in listing mode"},"templateEngine":{"type":"string","description":"Template generation engine (e.g. docxopenxml, xlsxaspose)"}}}}}}
```

## The ReportTemplateListResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"ReportTemplateListResponse":{"type":"object","properties":{"templates":{"type":"array","items":{"$ref":"#/components/schemas/ReportTemplate"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"ReportTemplate":{"type":"object","description":"Mail-merge template","properties":{"id":{"type":"integer","description":"Template identifier"},"name":{"type":"string","description":"Template name"},"listingMode":{"type":"boolean","description":"Whether the template is in listing mode"},"templateEngine":{"type":"string","description":"Template generation engine (e.g. docxopenxml, xlsxaspose)"}}}}}}
```

## The Report object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Report":{"type":"object","description":"Generated mail merge","properties":{"id":{"type":"integer","description":"Mail merge identifier"},"status":{"type":"string","description":"Mail merge status (e.g. finished, error)"},"original_document":{"type":"object","description":"File generated in the original format","properties":{"file_uuid":{"type":"string","description":"UUID of the generated file"},"file_name":{"type":"string","description":"Name of the generated file"}}},"pdf_document":{"type":"object","description":"File generated in PDF format","properties":{"file_uuid":{"type":"string"},"file_name":{"type":"string"}}},"errorMessage":{"type":"string","description":"Error message, if any"}}}}}}
```

## The ReportListResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"ReportListResponse":{"type":"object","properties":{"reports":{"type":"array","items":{"$ref":"#/components/schemas/Report"}},"total_count":{"type":"integer"},"next_page":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"Report":{"type":"object","description":"Generated mail merge","properties":{"id":{"type":"integer","description":"Mail merge identifier"},"status":{"type":"string","description":"Mail merge status (e.g. finished, error)"},"original_document":{"type":"object","description":"File generated in the original format","properties":{"file_uuid":{"type":"string","description":"UUID of the generated file"},"file_name":{"type":"string","description":"Name of the generated file"}}},"pdf_document":{"type":"object","description":"File generated in PDF format","properties":{"file_uuid":{"type":"string"},"file_name":{"type":"string"}}},"errorMessage":{"type":"string","description":"Error message, if any"}}}}}}
```

## The ReportInput object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"ReportInput":{"type":"object","required":["template_id","submission_id","api_callback"],"description":"Body for starting a mail merge","properties":{"template_id":{"type":"integer","description":"Template identifier (mandatory)"},"submission_id":{"type":"string","format":"uuid","description":"Submission identifier (mandatory)"},"api_callback":{"type":"string","description":"URL called (PUT) when generation completes; `{publipostage_id}` is substituted (mandatory)"},"header_name":{"type":"string","description":"HTTP header name to send during the callback (optional)"},"header_value":{"type":"string","description":"HTTP header value to send during the callback (optional)"},"join_format":{"type":"string","enum":["original","pdf","original,pdf"],"description":"Output format: `original`, `pdf`, or `original,pdf` (two reports generated)"}}}}}}
```

## The Subscription object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Subscription":{"type":"object","description":"Subscription attached to an account","properties":{"start":{"type":"integer","format":"int64","description":"Start date (UNIX timestamp)"},"end":{"type":"integer","format":"int64","description":"End date (UNIX timestamp)"},"users_max":{"type":"object","description":"Maximum number of web and mobile users","properties":{"web":{"type":"integer"},"mobile":{"type":"integer"}}},"id":{"type":"string","format":"uuid","description":"Subscription identifier"},"name":{"type":"string","description":"Displayed name"},"sequence":{"type":"integer","description":"Sequential number"},"active":{"type":"boolean","description":"Subscription status"},"used_licenses":{"type":"object","description":"Number of licenses already in use","properties":{"web":{"type":"integer"},"mobile":{"type":"integer"}}}}}}}}
```

## The SubscriptionListResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"SubscriptionListResponse":{"type":"object","properties":{"subscriptions":{"type":"array","items":{"$ref":"#/components/schemas/Subscription"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"Subscription":{"type":"object","description":"Subscription attached to an account","properties":{"start":{"type":"integer","format":"int64","description":"Start date (UNIX timestamp)"},"end":{"type":"integer","format":"int64","description":"End date (UNIX timestamp)"},"users_max":{"type":"object","description":"Maximum number of web and mobile users","properties":{"web":{"type":"integer"},"mobile":{"type":"integer"}}},"id":{"type":"string","format":"uuid","description":"Subscription identifier"},"name":{"type":"string","description":"Displayed name"},"sequence":{"type":"integer","description":"Sequential number"},"active":{"type":"boolean","description":"Subscription status"},"used_licenses":{"type":"object","description":"Number of licenses already in use","properties":{"web":{"type":"integer"},"mobile":{"type":"integer"}}}}}}}}
```

## The Group object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Group":{"type":"object","description":"Group within a workspace","properties":{"is_system":{"type":"boolean","description":"Whether this is a system group"},"id":{"type":"integer","description":"Group identifier"},"name":{"type":"string","description":"Displayed name"},"description":{"type":"string","description":"Description set by the administrator"},"user_ids":{"type":"array","description":"Identifiers of users in the group","items":{"type":"integer"}},"structure_ids":{"type":"array","description":"Identifiers of forms linked to the group","items":{"type":"integer"}}}}}}}
```

## The GroupInput object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"GroupInput":{"type":"object","required":["name","description"],"description":"Body for creating or updating a group","properties":{"name":{"type":"string","description":"Group name"},"description":{"type":"string","description":"Group description"},"user_ids":{"type":"array","description":"Identifiers of users in the group","items":{"type":"integer"}},"structure_ids":{"type":"array","description":"Identifiers of forms in the group","items":{"type":"integer"}}}}}}}
```

## The User object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"User":{"type":"object","description":"User (object returned by GET APIs)","properties":{"id":{"type":"integer","description":"Unique system-generated identifier"},"username":{"type":"string","format":"email","description":"Email address (login), must be unique"},"active":{"type":"boolean","description":"Status (active / inactive)"},"first_name":{"type":"string","description":"First name"},"last_name":{"type":"string","description":"Last name"},"subscription_id":{"type":"string","description":"UUID of the attached subscription"},"system_groups":{"type":"array","description":"System groups: 1 = administrator, 2 = mobile access, 3 = web access","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiers of the user's groups","items":{"type":"integer"}},"settings":{"type":"object","description":"User settings (e.g. locale)","additionalProperties":true}}}}}}
```

## The UserInput object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"UserInput":{"type":"object","required":["username","system_groups"],"description":"Body for creating or updating a user. Provide `plainPassword` for Daxium\nauthentication, or `ssoProvider` for SSO authentication.\n","properties":{"username":{"type":"string","format":"email","description":"Email address (login), must be unique"},"active":{"type":"boolean","description":"Status (active / inactive)"},"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"locale":{"type":"string","enum":["en","fr"],"description":"User language"},"subscription_id":{"type":"string","description":"Subscription UUID (see the `/subscriptions` API)"},"system_groups":{"type":"array","description":"System groups: 1 = administrator, 2 = mobile access, 3 = web access","items":{"type":"integer"}},"groups":{"type":"array","description":"Group identifiers (see the `/{app_short}/groups` API)","items":{"type":"integer"}},"plainPassword":{"type":"object","description":"Password. The `first` and `second` keys are mandatory and must be identical.\nRules: at least 1 uppercase, 1 lowercase, 1 digit, 8 characters total.\n","properties":{"first":{"type":"string","format":"password"},"second":{"type":"string","format":"password"}}},"force_login_password":{"type":"integer","enum":[0,1],"description":"[SSO companies only] 0 to deactivate, 1 to force Daxium login/password authentication"},"ssoProvider":{"type":"integer","nullable":true,"description":"[SSO companies only] Identifier of the SSO provider to use (provided by Daxium)"}}}}}}
```

## The UserListResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"UserListResponse":{"type":"object","properties":{"users":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"},"server_time":{"type":"integer","format":"int64"}}},"User":{"type":"object","description":"User (object returned by GET APIs)","properties":{"id":{"type":"integer","description":"Unique system-generated identifier"},"username":{"type":"string","format":"email","description":"Email address (login), must be unique"},"active":{"type":"boolean","description":"Status (active / inactive)"},"first_name":{"type":"string","description":"First name"},"last_name":{"type":"string","description":"Last name"},"subscription_id":{"type":"string","description":"UUID of the attached subscription"},"system_groups":{"type":"array","description":"System groups: 1 = administrator, 2 = mobile access, 3 = web access","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiers of the user's groups","items":{"type":"integer"}},"settings":{"type":"object","description":"User settings (e.g. locale)","additionalProperties":true}}}}}}
```

## The Company object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"Company":{"type":"object","description":"Company account of the current user","properties":{"created_at":{"type":"integer","format":"int64","description":"Creation date (UNIX timestamp)"},"updated_at":{"type":"integer","format":"int64","description":"Last update date (UNIX timestamp)"},"id":{"type":"integer","description":"Identifier"},"title":{"type":"string","description":"Displayed name"}}}}}}
```

## The CurrentUserResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"CurrentUserResponse":{"type":"object","properties":{"user":{"$ref":"#/components/schemas/User"},"company":{"$ref":"#/components/schemas/Company"}}},"User":{"type":"object","description":"User (object returned by GET APIs)","properties":{"id":{"type":"integer","description":"Unique system-generated identifier"},"username":{"type":"string","format":"email","description":"Email address (login), must be unique"},"active":{"type":"boolean","description":"Status (active / inactive)"},"first_name":{"type":"string","description":"First name"},"last_name":{"type":"string","description":"Last name"},"subscription_id":{"type":"string","description":"UUID of the attached subscription"},"system_groups":{"type":"array","description":"System groups: 1 = administrator, 2 = mobile access, 3 = web access","items":{"type":"integer"}},"groups":{"type":"array","description":"Identifiers of the user's groups","items":{"type":"integer"}},"settings":{"type":"object","description":"User settings (e.g. locale)","additionalProperties":true}}},"Company":{"type":"object","description":"Company account of the current user","properties":{"created_at":{"type":"integer","format":"int64","description":"Creation date (UNIX timestamp)"},"updated_at":{"type":"integer","format":"int64","description":"Last update date (UNIX timestamp)"},"id":{"type":"integer","description":"Identifier"},"title":{"type":"string","description":"Displayed name"}}}}}}
```

## The PushKeyInput object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"PushKeyInput":{"type":"object","description":"Push notification key for a device","properties":{"id":{"type":"string","description":"Unique device identifier"},"key":{"type":"string","description":"Push key"},"os":{"type":"string","description":"Device OS (Android or iOS)"},"os_version":{"type":"string","description":"OS version"},"app_version":{"type":"string","description":"Daxium-Air version"},"name":{"type":"string","description":"Device name"}}}}}}
```

## The UsersCallbackResponse object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"UsersCallbackResponse":{"type":"object","properties":{"callbackDetails":{"type":"object","properties":{"status":{"type":"string","enum":["Planned","Running","Finished","Finished with errors","Failed","In timeout"],"description":"Current job status"},"nbRecordsTodo":{"type":"integer","description":"Number of users to process"},"nbRecordsDone":{"type":"integer","description":"Number of users already processed"},"nbSuccess":{"type":"integer","description":"Number of users processed successfully"},"nbErrors":{"type":"integer","description":"Number of users that failed"},"success":{"type":"array","description":"Users created/updated successfully. Format: {\"<username>\": {\"id\": <user_id>}}","items":{"type":"object","additionalProperties":true}},"errors":{"type":"array","description":"Errors per user. Format: {\"<username>\": {\"<field>\": [\"<error>\"]}}","items":{"type":"object","additionalProperties":true}}}}}}}}}
```

## The View object

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"components":{"schemas":{"View":{"type":"object","description":"Configured submission view","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier"},"name":{"type":"string","description":"Localised name of the view"},"icon":{"type":"object","description":"Icon type and value","properties":{"type":{"type":"string"},"value":{"type":"string"}}},"view_mode":{"type":"string","description":"View display mode (e.g. table)"},"view_options":{"type":"object","description":"View options","properties":{"ordered_fields":{"type":"array","description":"Ordered list of fields to display (applicable if view_mode = table)","items":{"type":"string"}}}},"assigned_to_user":{"type":"boolean","nullable":true,"description":"Whether the view restricts submissions to those assigned to the current user"},"filters":{"type":"array","description":"Filtering rules for the view","items":{"type":"object","properties":{"structure_id":{"type":"integer","description":"Form identifier of the submissions to display"},"item_filters":{"type":"array","description":"Filtering rules on fields","items":{"type":"object","properties":{"name":{"type":"string","description":"System name of the field"},"type":{"type":"string","description":"Daxium-Air type of the field"},"operator":{"type":"string","description":"Operator to apply"},"values":{"type":"array","description":"Values to compare the field value against via the operator","items":{}}}}},"metadata_filters":{"type":"array","description":"Filtering rules on metadata","items":{"type":"object","properties":{"name":{"type":"string","description":"System name of the metadata"},"operator":{"type":"string","description":"Operator to apply"},"values":{"type":"array","items":{}}}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.center.daxium-air.com/api-reference/models.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.