Update task

Parameters

taskIdintegerpathRequired

ID of the task.

Request body

namestring

Task name (1 to 255 characters).

parentIdinteger | null

ID of the parent task. null makes the task top-level.

projectIdinteger

ID of the project the task belongs to.

responsibleUserIdinteger | null

ID of the user assigned to the task. null leaves it unassigned.

ballHoldingUserIdinteger | null

ID of the user who currently holds the ball, meaning who needs to act next. null means nobody.

statusIdinteger | null

ID of the status, which must belong to the task's project. null clears the status.

milestoneIdinteger | null

ID of the milestone, which must belong to the task's project. null clears the milestone.

priorityinteger | null

Priority: 1 is High, 2 is Mid, 3 is Low. null clears the priority.

descriptionstring | null

Task description as Markdown (up to 20,000 characters). null clears it.

startDatenumber | null

Start date as a Unix timestamp in milliseconds. null clears it.

dueDatenumber | null

Due date as a Unix timestamp in milliseconds. null clears it.

extraobject | null

Extra display settings. Only color (a color string such as #8CC230, or null) is meaningful.

applyToOpenDescendantsboolean

When true, subtasks that are not completed (including those with no status) also get the new statusId. Requires statusId. Defaults to false.

Responses

• 200Task updated
• 400Invalid request payload or move state
• 401Authentication is required
• 404Task not found