Update task
update_taskIdempotent
Update specific fields of an existing task by providing only the values you want to change. Modify title, status, priority, due date, tags, assignees, and more while keeping other details intact.
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 |