Skip to main content
PATCH
Update task
Requires the tasks:write scope. Viewers cannot edit tasks. Access-restricted members receive 403 if the task belongs to, or is being moved to, a list outside their permitted scope.

Path parameters

string
required
The numeric task ID.

Request body

All fields are optional. Send only the fields you want to update.
string
New task title. Cannot be set to an empty string.
string
Task description as an HTML string.
string
Task priority. Must be one of urgent, high, medium, low, or none.
string
Numeric ID of a workspace status to apply. The status must belong to the same workspace.
string
Numeric ID of a list to move the task into. The list must belong to the same workspace.
string | null
Due date in ISO 8601 UTC format (e.g., "2026-03-30T17:00:00Z"). Pass null or an empty string to remove the due date.
string | null
Start date in ISO 8601 UTC format. Pass null or an empty string to remove the start date.
array
Array of numeric user IDs to assign to the task. Replaces the current assignees entirely. Pass an empty array to remove all assignees. Omit this field to leave the current assignees unchanged. All IDs must be members of the same workspace; non-member IDs are silently ignored.
array
Optional array of custom field values to update. Each entry must contain a numeric id and a string value (or null to clear that field’s value). Omitting this field entirely leaves all custom field values unchanged. Only fields that apply to the task’s list and are visible to the API key user are processed; other fields are silently ignored.

Response

Returns the full updated task including its current assignees.
number
required
Task identifier.
number
required
Workspace this task belongs to.
number | null
List this task belongs to.
string
required
Task title.
string | null
Task description.
string
required
Task priority.
number
required
Workspace-scoped sequential task number.
string | null
UTC ISO-8601 due date.
string | null
UTC ISO-8601 start date.
number
required
User ID of the task creator.
string
required
UTC ISO-8601 creation timestamp.
object | null
Current task status.
array
required
Current assignees. Empty array if unassigned.
array
required
Custom fields that apply to the task’s list, each with its current value after the update. Fields the user does not have access to are not returned.