Update a task
Tasks
Update a task
Update a task: edit fields (action=update_fields), transition its status (action=transition_status), or (re)assign it (action=assign). All changes are reversible.
POST
Update a task
Headers
Project ID for tenant scoping
Overrides the key's workspace
User API key
Body
application/json
Which mutation to apply to the task.
Available options:
update_fields, transition_status, assign Task to update.
Field edits for action=update_fields - only set what changes. Explicit null on title/priority/sort_order is rejected (they can't be cleared this way); omit instead.
New status for action=transition_status.
Available options:
backlog, todo, in_progress, pending_human_approval, in_review, done, cancelled Assignee for action=assign.
Response
Successful Response
Available options:
backlog, todo, in_progress, pending_human_approval, in_review, done, cancelled Available options:
urgent, high, medium, low, none Available options:
human, ai_agent, system Available options:
human, ai_agent, system