Sign in

v2

latestOpenAPI 3.0.12026-07-31690160432.4 KB
Personal Subtasks

Create a subtask for a personal task

Create a new subtask for a given personal task

post/v1/tasks/{parentTaskId}/subtasks

Path parameters

parentTaskIdinteger required

ID of the parent task

Headers

X-Org-Idinteger required

Organization ID

Request body

taskTitlestring

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

descriptionstring

Description of the subtask.

ownersinteger[]

List of owner IDs assigned to the subtask.

startDatestring date-time

Start date of the subtask.

dueDatestring date-time

Due date of the subtask.

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 subtask. Must be between 0 and 100.

statusstring

Status of the subtask.

prioritystring

Priority of the subtask.

tagsstring[]

List of tags associated with the subtask.

Example request

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

Response

Subtask created successfully

successboolean

Indicates if the operation was successful

messagestring

Message describing the result of the operation

codeinteger

HTTP status code of the response

timestampstring date-time

Timestamp of the response

Example response

{
  "success": true,
  "message": "Operation completed successfully",
  "code": 200,
  "timestamp": "2023-01-01T12:00:00Z"
}