Skip to main content
Lists all tasks in an agent’s checklist. Returns a JSON array of task objects including their IDs, subjects, statuses, and dependency edges. A task with an activation condition is dormant until the condition is met — filesModified activates once the agent pushes a commit in the current run touching a file matching the pattern. Activation is evaluated against the agent’s pushed files, not against which checks CI runs. Dormant tasks don’t block the agent from finishing and shouldn’t be worked on; active incomplete tasks must be completed. Equivalent to murmur task ls in the CLI.

​
Parameters

NameTypeRequiredDescription
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.

​
Response

Returns a JSON array of task objects.
FieldTypeDescription
taskIdstringThe task’s unique ID.
subjectstringShort summary of the task.
descriptionstringDetailed task description.
statusstringTask status: TASK_STATUS_PENDING, TASK_STATUS_IN_PROGRESS, TASK_STATUS_COMPLETED, TASK_STATUS_DELETED.
blocksstring[]Task IDs that this task blocks.
blockedBystring[]Task IDs that block this task.
activationobjectConditional activation config, if set. The task is dormant (doesn’t block the agent) until the condition is met.

​
Examples

​
List own tasks

{}
Response: 
[
  {
    "taskId": "t_abc123",
    "subject": "Add pagination to the users API",
    "status": "TASK_STATUS_IN_PROGRESS"
  },
  {
    "taskId": "t_def456",
    "subject": "Update API docs",
    "status": "TASK_STATUS_PENDING",
    "blockedBy": ["t_abc123"]
  }
]

​
List another agent’s tasks

{
  "slug": "fix-auth"
}

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug. Use ls to see running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Check credentials.