Task Creation

Create simple or recurring tasks

Create a task

post

Creates a simple or a recurring task.

Authorizations

OAuth2passwordRequired

Send the access token as Authorization: Bearer <token>.

Token URL: Refresh URL:

---

OAuth2authorizationCodeRequired

Send the access token as Authorization: Bearer <token>.

Authorization URL: Token URL: Refresh URL:

Path parameters

app_shortstringRequired

Short name of the workspace, as found in the URL of the back-office.

Header parameters

X-Accept-Versionstring · enumOptional

API version to apply. Defaults to v1.0 when omitted; an unknown value falls back to the latest version.

Default: v1.3Possible values:

Body

Body for creating a task. Provide either submission_model_id or submissions. Add recurrency for a recurring task (in which case due_date is optional).

delay_afterintegerOptional

Indicative display delay in seconds after the task's due time

delay_beforeintegerOptional

Indicative display delay in seconds before the task begins

due_dateinteger · int64Optional

Due date (UNIX timestamp). Optional for a recurring task.

durationintegerOptional

Task duration in seconds

start_dateinteger · int64Required

Task start date (UNIX timestamp)

submission_model_idstring · uuidOptional

Identifier of a submission model

submissionsstring · uuid[]Optional

List of submission identifiers

user_idinteger · nullableOptional

Identifier of the assigned user

Responses

200

Task created

application/json

created_atinteger · int64Optional

deleted_atinteger · int64Optional

Deletion timestamp. Present only when the task has been deleted.

delay_afterintegerOptional

Indicative display delay in seconds after task completion time

delay_beforeintegerOptional

Indicative display delay in seconds before the task begins

due_dateinteger · int64Optional

Due date (Unix timestamp)

durationintegerOptional

Expected duration in seconds

fill_statusstring · enumOptional

Whether the linked submission's end-date field has been filled in.

Possible values:

idstring · uuidOptional

start_dateinteger · int64Optional

Planned start date (Unix timestamp)

time_statusstring · enumOptional

Whether the task is on time relative to its due date.

Possible values:

updated_atinteger · int64Optional

user_idintegerOptional

400

The payload is invalid.

application/json

401

Missing or invalid access token.

application/json

post/{app_short}/tasks

POST /{app_short}/tasks HTTP/1.1
Host: api.daxium-air.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 489

{
  "delay_after": 1,
  "delay_before": 1,
  "due_date": 1,
  "duration": 1,
  "recurrency": {
    "days": {
      "ANY_ADDITIONAL_PROPERTY": {
        "end": 1,
        "start": "text"
      }
    },
    "dayOfWeek": "text",
    "end": {
      "type": "occurrence",
      "value": 1
    },
    "interval": 1,
    "max_by_week": 1,
    "min_by_week": 1,
    "notDaysoff": true,
    "numofday": 1,
    "nth": 1,
    "repeatEvery": 1,
    "ruleMonth": "text",
    "taskTiming": "text",
    "type": "daily"
  },
  "start_date": 1,
  "submission_model_id": "123e4567-e89b-12d3-a456-426614174000",
  "submissions": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "user_id": 1
}

{
  "created_at": 1,
  "deleted_at": 1,
  "delay_after": 1,
  "delay_before": 1,
  "due_date": 1,
  "duration": 1,
  "fill_status": "filled",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "recurrency": {
    "days": {
      "ANY_ADDITIONAL_PROPERTY": {
        "end": 1,
        "start": "text"
      }
    },
    "dayOfWeek": "text",
    "end": {
      "type": "occurrence",
      "value": 1
    },
    "interval": 1,
    "max_by_week": 1,
    "min_by_week": 1,
    "notDaysoff": true,
    "numofday": 1,
    "nth": 1,
    "repeatEvery": 1,
    "ruleMonth": "text",
    "taskTiming": "text",
    "type": "daily"
  },
  "start_date": 1,
  "submission": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "structure_id": 1,
    "structure_version": 1,
    "items": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "channels": [
      "text"
    ],
    "user_id": 1,
    "last_updated_user_id": 1,
    "assigned_user": {},
    "user": {},
    "subscribers": [
      "text"
    ],
    "current_state": "123e4567-e89b-12d3-a456-426614174000",
    "submission_number": 1,
    "number_in_structure": 1,
    "latitude": 1,
    "longitude": 1,
    "settings": {},
    "task_id": "123e4567-e89b-12d3-a456-426614174000",
    "data_created_at": 1,
    "data_updated_at": 1,
    "created_at": 1,
    "updated_at": 1,
    "deleted_at": 1,
    "read_at": "2026-01-01T00:00:00.000Z"
  },
  "submission_model": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "structure_id": 1,
    "structure_version": 1,
    "items": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "channels": [
      "text"
    ],
    "user_id": 1,
    "last_updated_user_id": 1,
    "assigned_user": {},
    "user": {},
    "subscribers": [
      "text"
    ],
    "current_state": "123e4567-e89b-12d3-a456-426614174000",
    "submission_number": 1,
    "number_in_structure": 1,
    "latitude": 1,
    "longitude": 1,
    "settings": {},
    "task_id": "123e4567-e89b-12d3-a456-426614174000",
    "data_created_at": 1,
    "data_updated_at": 1,
    "created_at": 1,
    "updated_at": 1,
    "deleted_at": 1,
    "read_at": "2026-01-01T00:00:00.000Z"
  },
  "time_status": "normal",
  "updated_at": 1,
  "user_id": 1
}