---
title: "Permanently deletes the specified secret."
method: DELETE
path: "/deletedsecrets/{secret-name}"
tags: ["DeletedSecrets"]
---

# Permanently deletes the specified secret.

`DELETE /deletedsecrets/{secret-name}`

The purge deleted secret operation removes the secret permanently, without the possibility of recovery. This operation can only be enabled on a soft-delete enabled vault. This operation requires the secrets/purge permission.

## Path parameters

- `secret-name` string, required

## Query parameters

- `api-version` string, required

## Response `204`

No content signaling that the secret was purged forever.

## Other responses

- `default` — Key Vault error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/keyvaultclient.md) · [All operations](https://skmtc.net/azure/apis/keyvaultclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/keyvaultclient/revisions/1f612999ec40/schema)