Sign in
Personal Subtasks

Update a subtask for a personal task

Update an existing subtask for a given personal task

put/v1/tasks/{parentTaskId}/subtasks/{subtaskId}

Path parameters

parentTaskIdinteger required

ID of the parent task

subtaskIdinteger required

ID of the subtask to update

Headers

X-Org-Idinteger required

Organization ID

Request body

taskTitlestring

Title of the subtask. Optional for updates.

descriptionstring

Description of the subtask. Optional for updates.

ownersinteger[]

List of owner IDs assigned to the subtask. Optional for updates.

startDatestring date-time

Start date of the subtask. Optional for updates.

dueDatestring date-time

Due date of the subtask. Optional for updates.

noOfDaysinteger

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

completioninteger

Completion percentage of the subtask. Must be between 0 and 100. Optional for updates.

statusstring

Status of the subtask. Optional for updates.

prioritystring

Priority of the subtask. Optional for updates.

tagsstring[]

List of tags associated with the subtask. Optional for updates.

Example request

{
  "taskTitle": "Update user authentication",
  "description": "This subtask involves updating 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": 75,
  "status": "Completed",
  "priority": "Medium",
  "tags": [
    "frontend",
    "low-priority"
  ]
}

Response

Subtask updated 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