Cancel an eval run
POST/v1/projects/:project_id/evals/:eval_id/runs/:eval_run_id/cancel
Cancels a queued or running run: its outstanding item tasks are dropped so it stops consuming provider budget, and the run settles as cancelled.
Results already written are kept — they are real measurements of generations that were really paid for — and completed_count / errored_count report what ran. aggregate_scores is deliberately left null: a partial roll-up in the same field a completed run uses would read as a whole-dataset verdict.
A run that has already finished is rejected with 400.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
- 502
- 4XX
Eval run cancelled
The run has already finished
Unauthorized
Forbidden
Eval or run not found
QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens
Response Headers
Seconds until the quota window admits a request again
Internal server error
The deployment's admission service is asked about this write and did not answer — ADMISSION_UNAVAILABLE; the write did not happen
The deployment's admission service refused this write — answered under the service's own 4xx status, with its code (matching ^[A-Za-z_][A-Za-z0-9_]{0,63}$, not necessarily an ERROR_CODES key), message and meta; the write did not happen. A status this operation also declares on its own is documented there