> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Delete a secret"
description: "Delete a secret. Deployments that reference it lose access to the value on their next restart."
method: "DELETE"
endpoint: "/api/v1/secrets/:id"
order: 5
last_verified: 2026-07-27
---



`DELETE /api/v1/secrets/:id`

Delete a secret. Deployments that reference it lose access to the value on their next restart.


  ### Path parameters

  - `id` _string_ **required** — The secret's UUID.





> `GET /api/v1/secrets/:id/reveal` returns the decrypted plaintext value. It requires the **developer** role or above and should be called sparingly — prefer the masked listing for anything that doesn't need the raw value.