Update task
update_taskIdempotent
Modify any field of an existing task—title, status, priority, assignees, tags, due date, description. Pass only fields to change; returns the updated task.
Instructions
Update one or more fields of an existing task. Pass only the fields you want to change — all are optional. Returns the updated task.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Task UUID to update | |
| title | No | New title | |
| status | No | New status. Default values: OPEN, IN_PROGRESS, IN_REVIEW, NEEDS_INFO, DONE (= "Closed - done"), CLOSED (= "Closed - won't do"). Use NEEDS_INFO when the task is blocked waiting for clarification. A board may define custom statuses — read board.config.statuses from get_board. | |
| tag_ids | No | Replace the whole tag list with these tag IDs (empty array clears all tags) | |
| due_date | No | New due date as ISO string, or null to clear | |
| priority | No | New priority, low to high: MINOR, ORDINARY ("Low"), MEDIUM, IMPORTANT ("High"), BLOCKER. A board may define custom priorities — read board.config.priorities from get_board. | |
| stage_id | No | Assign to this stage ID, or null to remove (use get_board to see stages) | |
| column_id | No | Move to this kanban column ID (use list_board_columns to get IDs) | |
| parent_id | No | Set parent task UUID, or null to make top-level | |
| tag_names | No | Replace the whole tag list with these names (empty array clears all tags). Names are found on the board or created there. Max 10 per task. | |
| description | No | New description (markdown supported) | |
| watcher_ids | No | Replace full watcher list with these user UUIDs | |
| assignee_ids | No | Replace full assignee list with these user UUIDs | |
| original_estimate_minutes | No | Time estimate in minutes |