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.
Gets a single task by ID from an agent’s checklist. Returns the full task object including subject, description, status, and dependency edges.
Equivalent to murmur task get in the CLI.
Parameters
| Name | Type | Required | Description |
|---|
task_id | string | yes | ID of the task to retrieve. |
slug | string | no | Agent slug. Empty means self. Use an absolute path like /w/workspace/u/account/slug to target an agent outside your own path. |
workspace | string | no | Workspace name. Overrides the session default. |
Response
Returns a single task object.
| Field | Type | Description |
|---|
taskId | string | The task’s unique ID. |
subject | string | Short summary of the task. |
description | string | Detailed task description. |
status | string | Task status: TASK_STATUS_PENDING, TASK_STATUS_IN_PROGRESS, TASK_STATUS_COMPLETED, TASK_STATUS_DELETED. |
blocks | string[] | Task IDs that this task blocks. |
blockedBy | string[] | Task IDs that block this task. |
activation | object | Conditional activation config, if set. |
Examples
Get a task
{
"task_id": "t_abc123"
}
{
"taskId": "t_abc123",
"subject": "Add pagination to the users API",
"description": "Use cursor-based pagination with a default page size of 50.",
"status": "TASK_STATUS_IN_PROGRESS",
"blocks": ["t_def456"]
}
Get a task from another agent
{
"task_id": "t_abc123",
"slug": "fix-auth"
}
Errors
| Code | Meaning | What to do |
|---|
NOT_FOUND | Task or agent not found. | Check the task_id and slug. Use task_list to see existing tasks. |
UNAUTHENTICATED | Identity token is missing or expired. | Check credentials. |
