Update task
Partially update a task. assigneeUserIds/tagIds are full replacement sets when present (empty array clears); null clears dueAt, description, or the attached post. Moving workflowStatusId is how board drag-and-drop persists.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.
Task id (UUID), as returned by the list/create task endpoints.
Body
New title for the task, 1-500 characters. Omit to leave unchanged.
1 - 500Plain-text description used for search, card excerpts, and previews. Send null to clear it; omit to leave unchanged.
10000Rich (block-based) description document, stored verbatim for the task editor. Send null to clear it. Keep the plain-text description field in sync for search and previews.
Workspace-owned task workflow status id. Omit on create to use the first not_started task status.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Legacy task-state projection retained for checklist and summary compatibility. The workspace workflow status is authoritative.
todo, in_progress, done ISO-8601 instant the task is due. Send null to clear the due date; tasks with a due date also appear on the calendar.
Id of the post this task is attached to (its checklist), as returned by the list posts endpoint. Send null to detach; attached tasks are removed with their post.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Full replacement set of team-member user ids assigned to the task; an empty array clears every assignment. Non-members are silently ignored.
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Full replacement set of registry tag ids on the task (same registry as post tags); an empty array clears them. Tags from other teams are silently ignored.
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Response
Success
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$todo, in_progress, done a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$