Skip to main content

​
start_task

Start a new Autonomy coding task. Returns immediately with a task_id and status=running; the work executes in the background. Poll get_task(project_id, task_id) to track progress.
​
UUID
required
Target project UUID.
​
UUID
required
Workspace UUID for the project (from list_projects).
​
string
required
What the agent should do, in natural language.
​
string
Optional starting step: ‘planner’, ‘builder’, or ‘detect_component’. Leave null to let the orchestrator route.

​
continue_task

Send a follow-up message to an existing task and resume its workflow.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID to continue.
​
string
required
Follow-up message / instruction for the task.
​
string
Optional target step. Null stays on the current step.

​
get_task

Read-only Get the latest state of a task (poll this after start_task/continue_task). Check the task status to know when it is done (COMPLETED / DISCARDED) or needs input.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.

​
list_tasks

Read-only List the caller’s tasks for a project, most recently active first.
​
UUID
required
Project UUID.

​
get_task_messages

Read-only Get the chat/message history for a task (what the agent has said/done).
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.

​
get_task_pr_diff

Read-only Get the unified git diff the task produced — its ‘Files Changed’ view. This is how you pull the agent’s actual code changes back into the editor, even before a PR exists. Served from a per-version snapshot.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.
​
int
default:"1"
Version number to diff (the task’s version card). Use the active version from get_task; versions start at 1.

​
stop_task

Stop a running task, cancelling its in-flight agent run. Use this to abort a task that is going the wrong way. The task returns to a non-running state so you can continue_task with new guidance.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID to stop.

​
complete_task

Finalize a task and send it to devs (opens/updates the PR). Call only when the user has approved the task’s changes — this is the irreversible ‘ship it’ action. Runs in the background; poll get_task.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID to finalize.

​
checkout_task_version

Switch the task to one of its generated versions (its active version).
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.
​
int
required
Version id to switch the task to (from get_task).

​
discard_task_changes

Discard the changes made in a task’s sandbox (does not delete the task).
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.

​
archive_task

Archive a task (status → ARCHIVED). Non-destructive: the PR is untouched.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID to archive.

​
rename_task

Set the human-facing name/title of a task.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.
​
string
required
New human-facing task name (1–200 chars).

​
update_task_env

Re-sync the task sandbox’s environment after changing project env vars. Call after set_env_var when a task is already running so its sandbox picks up the new values. Runs in the background; poll get_task.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.

​
list_agent_histories

Read-only List the task’s agent-history metadata (one row per agent run/turn). Use to see which specialists ran; then get_agent_history_detail for the full trace of a single run.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.

​
get_agent_history_detail

Read-only Get the full message/tool-call trace for a single agent history.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.
​
UUID
required
History id from list_agent_histories.

​
list_spec_versions

Read-only List all versions of the task’s spec/plan document, newest first.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.

​
get_task_spec_version

Read-only Get the markdown content of a specific task spec/plan version.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.
​
int
required
Spec version number (1, 2, 3, …).

​
update_spec_content

Update the latest task spec/plan version in place (auto-save). Creates the first version if none exists yet. Use before building to shape the plan the agent will follow.
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.
​
string
required
New markdown for the latest spec.

​
create_spec_version

Save a new task spec/plan version explicitly (keeps history).
​
UUID
required
Project UUID.
​
UUID
required
Task UUID.
​
string
required
Markdown for the new spec version.