Update Task
update_task is one of the 32 MCP tools in Weft, the AI task manager you run by talking to Claude, Cursor, Codex or ChatGPT through one MCP endpoint. Patch an existing task's fields. Only fields you pass are changed; omitted fields are preserved — with one exception: clearing requiresReview is refused for an agent, and the refusal takes the whole patch with it.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
| id | uuid | yes | Task id to update. |
| title | string | no | New title. |
| description | string | no | New description (Markdown). |
| priority | "low" | "medium" | "high" | "urgent" | no | New priority. |
| project | string | null | no | New project — name (case-insensitive) or id; null detaches the task from its project. |
| assignee | string | null | no | New executor — a member’s name or email, "me" (the calling agent), or "none"/null to unassign. |
| estimateMinutes | integer | no | New estimate in minutes. |
| dueAt | ISO-8601 datetime string | null | no | New due date; pass null to clear. |
| requiresReview | boolean | no | Stop at the user before this counts as done. For the irreversible only — money, publishing outward, production, anything legal; everything else finishes without them. An agent can turn it on but not off: while the flag stands only you clear it, by accepting the work in your queue or in the app, and a false sent against a standing flag is refused together with the rest of that patch. |
| verification | { mode, checks[] } | null | no | Replace the verification plan (null removes it). Any write resets every check to pending — a new plan is unverified by definition. See create_task for the shape. |
| blockedBy | uuid[] | no | REPLACE the set of tasks blocking this one — what you pass is what holds; [] unblocks entirely. Cycles are refused. |
Returns
The updated task.
Annotations
- idempotent. Calling the tool twice with the same arguments has the same effect as calling it once.
Example
What the user says:
"Bump the priority of the auth refactor to urgent."Related
- All 32 MCP tools — the catalog view.
- Shuttle — how the AI client uses these tools.
- Call this tool through your own client: see setup guides, or hit
https://letsweft.com/api/mcpdirectly.