Skip to content

Search Documentation

Search across all documentation pages

update_task

Update an existing task's status, priority, or assignment on the kanban board. Tasks are memories -- this updates the memory's metadata and importance. All update fields are optional.

Parameters#

ParameterTypeRequiredDescription
taskIdstring (UUID)requiredID of the task (memory) to update
statusstringoptionalNew status: backlog, todo, in_progress, done, blocked
priorityinteger (1-5)optionalNew priority (1-5)
assignedAgentIdstring (max 200 chars) or nulloptionalAssign to a specific agent, any for any agent, or null to unassign
doneWhenstring (max 1000 chars) or nulloptionalNatural language completion criteria. Set null to clear.

Returns#

Confirmation of the update with the task ID and updated fields.

Example#

json
{
  "tool": "update_task",
  "arguments": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "in_progress",
    "assignedAgentId": "claude_code"
  }
}