Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt

Use this file to discover all available pages before exploring further.

Updates an existing task in an agent’s checklist. Can change the task’s status, subject, description, or add dependency edges between tasks. Equivalent to murmur task update in the CLI.

​
Parameters

NameTypeRequiredDescription
task_idstringyesID of the task to update.
statusstringnoNew task status: pending, in_progress, completed, or deleted.
subjectstringnoNew task subject.
descriptionstringnoNew task description.
add_blocksstring[]noTask IDs that this task blocks. Adds forward dependency edges.
add_blocked_bystring[]noTask IDs that block this task. Adds reverse dependency edges.
slugstringnoAgent slug. Empty means self. Use an absolute path like /w/workspace/u/account/slug to target an agent outside your own path.
workspacestringnoWorkspace name. Overrides the session default.

​
Dependency edges

Tasks can declare dependencies on other tasks using add_blocks and add_blocked_by. These edges express ordering constraints:
  • add_blocks: “this task blocks those tasks” — the listed tasks cannot start until this one completes.
  • add_blocked_by: “this task is blocked by those tasks” — this task cannot start until the listed tasks complete.
Both directions create the same underlying edge. Use whichever reads more naturally for your use case.

​
Response

Returns a confirmation string: updated task <task_id>.

​
Examples

​
Mark a task completed

{
  "task_id": "t_abc123",
  "status": "completed"
}
Response: 
updated task t_abc123

​
Update subject and description

{
  "task_id": "t_abc123",
  "subject": "Add pagination to the users API (v2)",
  "description": "Use cursor-based pagination instead of offset."
}

​
Add dependency edges

{
  "task_id": "t_deploy",
  "add_blocked_by": ["t_tests", "t_review"]
}
This means t_deploy cannot start until both t_tests and t_review are completed.

​
Delete a task

{
  "task_id": "t_abc123",
  "status": "deleted"
}

​
Errors

CodeMeaningWhat to do
INVALID_ARGUMENTUnknown status value or invalid task ID.Check the error message. Valid statuses: pending, in_progress, completed, deleted.
NOT_FOUNDTask or agent not found.Check the task_id and slug. Use task_list to see existing tasks.
UNAUTHENTICATEDIdentity token is missing or expired.Check credentials.