Skip to main content
POST
Get a task

Authorizations

Authorization
string
header
required

murmur API key: mur_<key_id>.

Body

application/json
agentId
object

Identifies an agent. The identity is (tenant, workspace, owner, agent path); the workspace scopes the agent's repos, environment, and base branches.

task
object

TaskGetRequest retrieves a single task by ID.

Response

A successful response.

A checklist item on the agent's task list.

id
string
subject
string
description
string
status
enum<string>
default:TASK_STATUS_UNSPECIFIED

TaskStatus is the lifecycle state of a checklist task.

Available options:
TASK_STATUS_UNSPECIFIED,
TASK_STATUS_PENDING,
TASK_STATUS_IN_PROGRESS,
TASK_STATUS_COMPLETED,
TASK_STATUS_DELETED
blocks
string[]
blockedBy
string[]
activation
object

Defines when a task becomes active. At most one condition may be set; unset means always active.

persona
string

Name of the persona that contributed this task (e.g. "programmer"). Empty for tasks from the spawn request, follow-ups, or task_create. A persona switch removes exactly the persona-tagged tasks and adds the new persona's, leaving all untagged tasks in place.

dedupKey
string

Stable identity of the external object this task tracks (e.g. a PR review thread). Tasks with the same key are de-duplicated within one delivery batch. Empty for caller-created tasks, which are never de-duplicated.

ephemeral
boolean

Ephemeral tasks live for exactly one run: created with the follow-up that delivers them and removed when that run completes. Set by the platform on per-thread PR comment and review tasks.