RUNSRESOURCE

[ 01 ]Create a run

Creates and executes a run. The call is synchronous for y0-fast and returns 201 with the completed run; y0-deep runs may return status "running" — poll with GET until completed. Pass an Idempotency-Key header to make retries safe.

{
  "model": "y0-fast",
  "prompt": "Prepare my Thursday.",
  "context": ["calendar", "documents"],
  "max_steps": 4
}

{
  "id": "run_4af2c19e",
  "object": "run",
  "status": "completed",
  "model": "y0-fast",
  "steps_used": 2,
  "max_steps": 4,
  "created_at": "2026-06-10T07:31:04Z",
  "result": {
    "summary": "Thursday brief drafted — 1 deadline, 1 invoice, 1 draft.",
    "artifacts": ["doc_thursday_brief"]
  }
}

[ 02 ]Retrieve a run

Returns the run with its full trace: the plan, every context fetch and the scope that authorized it, every step, and the result. Traces are replayable — the same trace renders identically forever.

{
  "id": "run_4af2c19e",
  "object": "run",
  "status": "completed",
  "trace": [
    { "type": "plan",    "ms": 96,  "steps": 2 },
    { "type": "context", "source": "calendar",
      "scope": "calendar:read", "items": 3 },
    { "type": "step",    "n": 1, "action": "collect_deadlines" },
    { "type": "step",    "n": 2, "action": "draft_brief" },
    { "type": "result",  "ms_total": 612 }
  ]
}

[ 03 ]Delete a run

Permanently removes the run record and its trace. The trust kernel's audit log entries are retained — deletion erases your data, not the record that an access happened.

{
  "id": "run_4af2c19e",
  "object": "run",
  "deleted": true
}