---
title: "Delete a terminal eval run"
method: DELETE
path: "/v1/eval-runs/{run_id}"
tags: ["evals", "evals"]
---

# Delete a terminal eval run

`DELETE /v1/eval-runs/{run_id}`

Hard-delete a terminal eval run; its scores cascade (ORM
``delete-orphan`` + DB FK ``ON DELETE CASCADE``).

Terminal-only **allow-list**: rejects (409) anything not
``completed``/``failed``/``errored`` — so pending/running and any future
non-terminal state are blocked. Cross-org/unknown → 404. ``get_session()``
auto-commits on success.

## Path parameters

- `run_id` string, uuid, required

## Response `204`

Successful Response

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `404` — Resource not found
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)
