> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# Delete secret

> Delete one caller-owned Vault secret.

Delete one Vault secret by name. Deletion is permanent for the named secret.

## Delete a secret

```ts
const result = await bctrl.tools.call("vault.secrets.delete", {
  name: "production/github/api-token",
});

console.log(result.name, result.deleted); // true
```

Inspect metadata with [Get secret metadata](/sdk/tools/vault/vault-secrets-get)
or [List secrets](/sdk/tools/vault/vault-secrets-list) before deleting.

## Request parameters

| Parameter | Type              | Required | Description                                                                                                      |
| --------- | ----------------- | -------- | ---------------------------------------------------------------------------------------------------------------- |
| `name`    | `VaultSecretName` | Yes      | Secret name made from slash-separated letters, numbers, `.`, `_`, `~`, and `-` segments. Maximum 256 characters. |

## Response

| Field     | Type              | Always present | Description          |
| --------- | ----------------- | -------------- | -------------------- |
| `name`    | `VaultSecretName` | Yes            | Deleted secret name. |
| `deleted` | `true`            | Yes            | Confirms deletion.   |

## Next

* [List secrets](/sdk/tools/vault/vault-secrets-list) — inspect safe metadata
* [Get secret metadata](/sdk/tools/vault/vault-secrets-get) — read one secret's metadata
* [Spaces](/sdk/spaces) — configure Vault access