API reference

Tasks and events API

Submit an outcome, follow its durable event stream, and provide input or takeover when the task asks for a human.

Create a task

POST/v1/tasks

Request

{
  "task": "Compare the top three launch stories",
  "agent": "auto",
  "computer": {
    "surface": "browser",
    "provider": "t/browser"
  },
  "client_ref": "tool_opaque"
}

Stream events

GET/v1/tasks/{id}/events

Request text/event-stream for live updates. Reconnect with Last-Event-ID. Use ?after=<sequence> for replayable JSON.

Provide input

POST/v1/tasks/{id}/input

Supported actions are message, takeover, release, pause, resume, complete, and cancel.

List artifacts

GET/v1/tasks/{id}/artifacts

Artifact manifests link the result to its task, execution, computer, digest, and short-lived actor-bound download URL.