Sign in
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:00.000Z",
  "dueDate": "2023-10-15T00:00:00.000Z",
  "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"
}

Changes

Changed in 2 of the 10 revisions of this API.12

  • 237f5bbd402911See the full diff
    • ▲

      the data/customFields/items/fieldValue/items/value response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ○

      added the optional property data/internal to the response with the 200 status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • a8f0641b72121See the full diff
    • ○

      endpoint added

      endpoint-added