by ClickUp
Update a task
Changes the fields you send on a task, such as its name, description, status, priority, dates or assignees, and leaves the rest as they were.
Updated Sep 27, 2026
update-task.md
Update a task
Changes the fields you send on a task, such as its name, description, status, priority, dates or assignees, and leaves the rest as they were.
Note: Statuses differ per List and must match exactly: confirm them first with clickup_get_task and expand_statuses: true. On the API, change assignees with an assignees object of add and rem user id arrays.
Set up
Use the first option your agent supports.
MCP (official, remote)
Add this server to your agent's MCP settings, then sign in when asked.
{ "mcpServers": { "clickup": { "url": "https://mcp.clickup.com/mcp" } } }
Call the MCP tool clickup_update_task.
Server URL: https://mcp.clickup.com/mcp
API (official)
- Base URL: https://api.clickup.com/api
- Endpoint:
PUT /v2/task/{task_id} - Auth: send the header
Authorization: $CLICKUP_API_KEY - Get a key: https://app.clickup.com/settings/apps
- Docs: https://developer.clickup.com/docs/authentication
Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.