---
title: "Delete a variant"
method: DELETE
path: "/v0/projects/{project}/benchmarks/{benchmark}/variants/{variant}"
tags: ["projects", "variants"]
---

# Delete a variant

`DELETE /v0/projects/{project}/benchmarks/{benchmark}/variants/{variant}`

## Request

- The document declares no server URL.
- Auth: none declared

Delete a variant for a benchmark. The user must have `delete` permissions for the project. All reports that use this variant must be deleted first!

A benchmark's empty variant cannot be deleted. The empty variant is structural: every benchmark is born with exactly one, and report ingest treats a missing empty variant as data corruption rather than a variant to mint. Deleting it would manufacture exactly that corruption, so the request is refused. Archiving the empty variant stays allowed, because a later report revives it the same way it revives any other archived variant.

## Path parameters

- `benchmark` string, required
- `project` string, required
- `variant` string, uuid, required

## Response `204`

successful deletion

## Other responses

- `4XX`: Error
- `5XX`: Error

## Changes

- **2026-09-18** `2ca549d2a218`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/projects/:project/benchmarks/:benchmark/variants/:variant/delete.md)

---

[API](https://skmtc.dev/bencherdev/apis/bencher-api.md) - [All operations](https://skmtc.dev/bencherdev/apis/bencher-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bencherdev/apis/bencher-api/revisions/538b39b8d755?raw)