Skip to main content

​
List Tasks

GET /tasks
GET /tasks?status=running
GET /tasks?type=recurring

​
Create Task

POST /tasks
{
  "goal": "Research AI news weekly",
  "taskType": "recurring",
  "schedule": { "interval": "weekly" },
  "approval": { "mode": "first_n", "firstN": 3 }
}

​
Get Task Details

GET /tasks/:id
Returns full task state: goal, plan, schedule, memory, approval history.

​
Update Task

PUT /tasks/:id
{ "goal": "Updated goal", "approval": { "mode": "never" } }

​
Task Controls

POST /tasks/:id/start    # Start a planned task
POST /tasks/:id/pause    # Pause a running task
POST /tasks/:id/resume   # Resume a paused task
POST /tasks/:id/run      # Trigger immediate execution
DELETE /tasks/:id         # Delete a task

​
Approve/Reject

POST /tasks/:id/approve
{ "approved": true, "notes": "Looks good, keep doing this" }

​
Execution History

GET /tasks/:id/runs

​
Real-Time Events (SSE)

GET /tasks/events
Event types: task:start, task:phase, task:tool, task:eval, task:complete, task:approval, task:error