Queue work for the personal assistant

Enqueue, edit, reorder, and cancel tasks on an AGI run.

Queue work for the personal assistant

One run can hold many tasks. The assistant works them in order. You can change queued items before they start.

Spawn with a queue

POST /v1/api/agi/runs
Authorization: Bearer <token>
Content-Type: application/json

{
  "plane": "personal",
  "goal": "Plan my morning",
  "tasks": [
    { "message": "List today's calendar", "title": "Calendar" },
    { "message": "Check wallet balances", "title": "Money" }
  ]
}

Save capToken from the response. It is returned once.

Manage tasks

Action	Request
List	`GET /v1/api/agi/runs/:runId/tasks`
Add	`POST /v1/api/agi/runs/:runId/tasks` with `message`
Edit	`PATCH /v1/api/agi/runs/:runId/tasks/:taskId` (queued only)
Reorder	`POST /v1/api/agi/runs/:runId/tasks/reorder` with all queued `taskIds`
Cancel	`POST /v1/api/agi/runs/:runId/tasks/:taskId/cancel` (queued only)

Run the next step

POST /v1/api/agi/runs/:runId/step
Authorization: Bearer <token>
Content-Type: application/json

{ "capToken": "<from spawn>", "execute": true }

If a task is queued or already running, its message is used. Otherwise send message in the body.

Write actions may pause for confirm — decide with /interrupts/:interruptId/decide.