Get an eval run overview
Aggregate header for one run’s trials view: trial counts, average reward, cost, and the input/output/cached token split. Its own route rather than fields on the run object because it scans the run’s samples — folding it into GET /evals/runs/{run_id} would charge that scan to every run list and to the status polling that runs for the whole length of an eval. trials.errored overlaps trials.failed instead of partitioning it: a coding-agent trial can carry an agent timeout in error and still be completed and scored. trials.retried counts trials rerun through rerun-failed, read from the pre-rerun snapshot, since a rerun overwrites the sample in place.
Authorizations
Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.
Headers
Optional external end-user identifier forwarded by the API gateway.
Path Parameters
Query Parameters
The scores key avg_reward averages. Defaults to reward, what the harness writes for a pass/fail task.
128^[\w.-]+$Response
OK
queued, in_progress, finalizing, completed, failed, cancelling, cancelled Mean of metric over trials that carry it numerically. Null when none do.
Summed over the run's trials. Each field is null when no trial reported it.