---
title: "Archive an eval prompt set"
method: DELETE
path: "/v1/ai/eval/prompt-sets/{promptSetId}"
tags: ["AI Eval"]
---

# Archive an eval prompt set

`DELETE /v1/ai/eval/prompt-sets/{promptSetId}`

Archive (soft-delete) a prompt set. Omni also attempts to cancel every in-flight agentic job associated with the set; the returned `cancelled_job_count` reports how many were cancelled. Cancellation is best-effort — the archive is committed first, so if a run-cancellation later fails the endpoint returns 500 even though the set is already archived. The call is idempotent: retrying drains any remaining runs.

## Path parameters

- `promptSetId` string, uuid, required — The unique identifier of the eval prompt set.

## Response `200`

Prompt set archived successfully.

- EvalPromptSetsDeleteResponse
  - `cancelled_job_count` integer, required — Number of in-flight agentic jobs associated with this prompt set that were cancelled as part of the archive.
  - `is_archived` true, required — Always `true` on success — archives the prompt set.

## Other responses

- `400` — Invalid `promptSetId` — must be a UUID.
- `401` — Missing or invalid API key.
- `403` — Insufficient permissions.
- `404` — Prompt set not found.
- `500` — Archive committed but a run-cancellation failed; the set is already archived — safe to retry.

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)