---
title: "DELETE /subjects/{subject}/versions/{version}"
method: DELETE
path: "/subjects/{subject}/versions/{version}"
tags: ["Subjects"]
---

# DELETE /subjects/{subject}/versions/{version}

`DELETE /subjects/{subject}/versions/{version}`

## Request

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

Performs a soft or hard delete on the specified schema version. Hard delete requires the exact version number (not 'latest').

## Path parameters

- `subject` string, required
- `version` string, required

## Query parameters

- `permanent` boolean

## Headers

- `X-Registry-GroupId` string

## Response `200`

The version number that was deleted.

- integer

## Other responses

- `404`: Error returned by the Schema Registry API
- `422`: Error returned by the Schema Registry API
- `500`: Error returned by the Schema Registry API

---

[API](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api.md) - [All operations](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api/revisions/a2f9ca447c9b?raw)