update_task
Update any field of a task by specifying only the fields to change. Supports modifying status, priority, due date, assignees, custom fields, and more.
Instructions
Update any field of a task. Pass only the fields you want to change.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Task ID. | |
| name | No | ||
| description | No | Plain-text description. | |
| markdown_content | No | Markdown description (overrides description). | |
| status | No | ||
| priority | No | 1=urgent .. 4=low, null clears. | |
| due_date | No | Date as ISO string, epoch ms, or relative ("tomorrow", "in 3 days", "+2h"). | |
| due_date_time | No | ||
| start_date | No | Date as ISO string, epoch ms, or relative ("tomorrow", "in 3 days", "+2h"). | |
| start_date_time | No | ||
| time_estimate | No | Estimate in milliseconds. | |
| assignees | No | Full set of assignee user ids. On update this REPLACES the current assignees (use assignees_add/assignees_rem for incremental changes). | |
| tags | No | ||
| parent | No | Parent task id (makes this a subtask). | |
| custom_fields | No | Array of { id, value } custom field assignments. | |
| custom_item_id | No | Custom task type id. | |
| archived | No | ||
| assignees_add | No | Assignees to add (incremental). | |
| assignees_rem | No | Assignees to remove (incremental). | |
| custom_task_ids | No | Treat task_id as a custom id (requires team_id). | |
| team_id | No | Team/Workspace ID. Falls back to CLICKUP_TEAM_ID when omitted. |