Runs

The Runs API creates and reads evaluation runs: fetch a run and its 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.

Credits: 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