Run Sessions

A run session represents a single execution of an agent. Tasks are always submitted within the context of a run.

Start a run

POST /api/v1/runs

{
  "projectType": "accessibility-audit",
  "targetUrl": "https://example.com",
  "metadata": {
    "branch": "main",
    "commit": "abc123"
  }
}

{
  "id": "run_xyz789",
  "projectType": "accessibility-audit",
  "status": "running",
  "createdAt": "2026-03-31T10:00:00Z"
}

GET /api/v1/runs

GET /api/v1/runs/:id

Returns run metadata plus a summary of task counts by severity and status.