> 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
---

<ApiEndpoint
  method="DELETE"
  endpoint="/api/v1/secrets/:id"
  description="Delete a secret. Deployments that reference it lose access to the value on their next restart."
>
  <section>
    ### Path parameters

    <ApiAttribute name="id" type="string" description="The secret's UUID." required={true} />
  </section>
</ApiEndpoint>

<Callout type="info">
`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.
</Callout>