work_update
tools/call
Update task details, next action, priority, story points, tags, due date, or visibility.
Scopes
write:work
On a board moved to Projects, a new description is written to the task's document, under the same write:work.
Inputs
- itemIdstringRequired
- Work item ID
- titlestring
- Task title
- descriptionstring
- Full description
- documentCASobject
- nextActionstring
- Concrete next action
- priority"low" | "normal" | "high" | "urgent"
- storyPoints1 | 2 | 3 | 5 | 8 | null
- tagsstring[]
- dueAtnumber | null
- visibility"private" | "tenant"
- idempotencyKeystringRequired
- Unique retry key
Returns
The updated work item. A call returns content[0].text with the JSON result and structuredContent.result with the same value.
Listed when
The key has agent access.