---
title: "Delete a secret (tombstone; erases every stored value; resolution stops immediately)"
method: DELETE
path: "/v1/secrets/{secret_id}"
tags: ["Secrets"]
---

# Delete a secret (tombstone; erases every stored value; resolution stops immediately)

`DELETE /v1/secrets/{secret_id}`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/secrets/{secret_id}`
- Auth: HTTP bearer

Any session start after this returns it as denied. The name becomes reusable. The name is removed from every workspace binding that referred to this secret (same transaction, one audit event per workspace). Values already injected into running processes cannot be recalled. Repeating returns 204.

## Path parameters

- `secret_id` string, uuid, required

## Response `204`

No content.

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

[API](https://skmtc.dev/shardflux/apis/shardflux-api.md) · [All operations](https://skmtc.dev/shardflux/apis/shardflux-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shardflux/apis/shardflux-api/revisions/ea685f7b39c4?raw)