---
title: "Delete Eval"
method: DELETE
path: "/v2/evals/{eval_uuid}"
tags: ["Evals"]
---

# Delete Eval

`DELETE /v2/evals/{eval_uuid}`

Delete an eval.

Args:
    eval_uuid (str): UUID of the eval to delete.
    workspace_uuid (str, optional): Optional workspace UUID for filtering.

Returns:
    None

Raises:
    AymaraAPIError: If the eval is not found.

Example:
    DELETE /api/evals/{eval_uuid}

## Path parameters

- `eval_uuid` string, required

## Query parameters

- `workspace_uuid` string

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

## Changes

- **2025-10-29** `9b529d67a7d0` — 9 warning
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `400`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `401`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `403`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `404`
  - …5 more

[Change history](https://skmtc.dev/aymara-ai/apis/aymara-api/changes/v2/evals/:eval_uuid/delete.md)

---

[API](https://skmtc.dev/aymara-ai/apis/aymara-api.md) · [All operations](https://skmtc.dev/aymara-ai/apis/aymara-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aymara-ai/aymara-api/revisions/0cb64ef11adf/schema)