Skip to main content
Creates a new task in an agent’s checklist. Returns the task ID. Tasks appear in the agent’s status and guide the agent through multi-step work. Equivalent to murmur task create in the CLI.

​
Parameters

NameTypeRequiredDescription
subjectstringyesShort summary of the task.
descriptionstringnoDetailed task description.
activate_whenstringnoActivation condition name. When set, the task starts dormant and only blocks the agent’s exit once the condition is met; dormant tasks never block. Valid: files_modified — met once the agent pushes a commit in the current run touching a file matching pattern.
patternstringnoGlob matched against the file paths the agent pushes (e.g. *.go, **/*_test.go). Empty matches any pushed file. Only used with activate_when: files_modified.
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.

​
Conditional activation

When activate_when is set, the task starts in a dormant state and is automatically activated when the condition is met. Currently the only supported condition is files_modified — the task activates once the agent pushes a commit in the current run that touches a file matching pattern. Activation is evaluated against the files the agent pushes, not against PR contents or which checks CI runs. While dormant, the task does not block the agent from finishing; once activated, the agent must run it and mark it completed. This is useful for attaching review or testing tasks that only make sense after specific files change. For example, a task to “run integration tests” that activates when **/*_test.go files are modified.

​
Response

Returns a JSON object with the created task’s ID.
FieldTypeDescription
task_idstringThe ID of the created task.

​
Examples

​
Create a simple task

{
  "subject": "Add pagination to the users API"
}
Response: 
{
  "task_id": "t_abc123"
}

​
Create a task on another agent

{
  "slug": "fix-auth",
  "subject": "Update the API docs after fixing auth",
  "description": "The OpenAPI spec needs to reflect the new auth flow."
}

​
Create a conditionally activated task

{
  "subject": "Run integration tests",
  "description": "Verify the test suite passes after modifying test files.",
  "activate_when": "files_modified",
  "pattern": "**/*_test.go"
}

​
Errors

CodeMeaningWhat to do
INVALID_ARGUMENTMissing subject or unknown activate_when value.Check the error message and fix the input.
NOT_FOUNDNo agent with that slug exists.Check the slug. Use ls to see running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Check credentials.