Sign in

v3

latestOpenAPI 3.1.02026-08-08690159432.1 KB
Personal Tasks

Create a task

Create a new task

post/v1/tasks

Headers

X-Org-Idinteger required

Organization ID

Request body

taskTitlestring

Title of the task. Must be between 3 and 500 characters.

descriptionstring

Description of the task.

ownersinteger[]

List of owner IDs assigned to the task.

startDatestring date-time

Start date of the task.

dueDatestring date-time

Due date of the task.

noOfDaysinteger

Duration in working days. When sent together with startDate or dueDate, the missing date is computed by honouring the organisation's operational hours.

completioninteger

Completion percentage of the task. Must be between 0 and 100.

statusstring

Status of the task.

prioritystring

Priority of the task.

tagsstring[]

List of tags associated with the task.

Example request

{
  "taskTitle": "Implement authentication module",
  "description": "This task involves implementing the authentication module for the application.",
  "owners": [
    1,
    2,
    3
  ],
  "startDate": "2023-10-01T00:00:00.000Z",
  "dueDate": "2023-10-15T00:00:00.000Z",
  "noOfDays": 5,
  "completion": 50,
  "status": "In Progress",
  "priority": "High",
  "tags": [
    "backend",
    "urgent"
  ]
}

Response

Task created successfully