clickup_update_task
Update an existing task by changing its name, status, description, priority, dates, assignees, or other fields. Incrementally add or remove assignees without overwriting existing ones.
Instructions
Update fields on an existing task.
Calls PUT /task/{task_id}. Change the name, description (plain or markdown),
status, priority, dates, time estimate, points, parent, or archived flag. Add
or remove assignees and group assignees incrementally via the
add_assignees / remove_assignees (and group equivalents) lists — ClickUp
sends these as {"assignees": {"add": [...], "rem": [...]}}.
When to Use:
To edit an existing task or (re)assign people.
When NOT to Use:
To create a task — use
clickup_create_task.To move a task to a different List — use
clickup_move_task.For a single custom-field write,
clickup_set_custom_field_valueis more reliable than thecustom_fieldsbody here.
Returns: A confirmation string naming the task and the fields that changed.
Examples:
Reassign:
params = {"task_id": "86cxy1", "add_assignees": [123], "remove_assignees": [456]}Retitle + close:
params = {"task_id": "86cxy1", "name": "New title", "status": "complete"}
Error Handling: 400 often means an unknown status name; 404 means the task id is wrong.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |