Runs

The Runs API creates, reads, updates and deletes evaluation runs: fetch a run and its evaluation rows, export a CSV, start a run from a saved dataset, or send inline rows with a custom run.

Base path: /runs. All routes require a Bearer API key.

Billing: POST /runs/dataset and POST /runs/custom can return 402 when balance is insufficient (before the run is created). Shared HTTP semantics: status codes and errors.

Endpoints

• Create run from dataset — POST /runs/dataset
• Create custom run — POST /runs/custom
• Get run — GET /runs/{run_id}
• Update run — PUT /runs/{run_id}
• Download run — GET /runs/{run_id}/download
• Delete run — DELETE /runs/{run_id}