> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# murmur secret rm

> Delete a tenant secret permanently — already-running agents continue to hold the value in memory until they terminate or are rekeyed.

Deletes a [secret](/catalog/secret) from your tenant. The [secret](/catalog/secret) is removed immediately — agents spawned after deletion no longer receive it as an environment variable. See [profiles and secrets](/concepts/secrets) for how [secrets](/catalog/secret) are delivered to agents.

<Warning>
  Deletion is permanent and takes effect immediately. There is no confirmation prompt and no undo. Running agents that were spawned before the deletion retain the [secret](/catalog/secret) for the remainder of their session.
</Warning>

## Synopsis

```bash theme={null}
murmur secret rm <NAME>
```

## Arguments

| Name   | Type   | Required | Description                                          |
| ------ | ------ | -------- | ---------------------------------------------------- |
| `NAME` | string | yes      | The name of the [secret](/catalog/secret) to delete. |

## Examples

### Delete a secret

```bash theme={null}
murmur secret rm NPM_TOKEN
```

```
Deleted secret "NPM_TOKEN"
```

## Errors

| Code               | Meaning                                                    | What to do                                                                                                      |
| ------------------ | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `NOT_FOUND`        | No [secret](/catalog/secret) with that name exists.        | Check the name spelling. Use [`murmur secret ls`](/cli/secret-ls) to see configured [secrets](/catalog/secret). |
| `INVALID_ARGUMENT` | `secret name "GH_TOKEN" is reserved and cannot be deleted` | `GH_TOKEN` is provided automatically and cannot be deleted.                                                     |
| `UNAUTHENTICATED`  | Identity token is missing or expired.                      | Run `murmur auth` or check your `murmur.local.yaml` configuration.                                              |

## Related

* [`secret`](/catalog/secret) — catalog resource reference
* [Profiles and secrets](/concepts/secrets) — concept overview
* [`murmur secret set`](/cli/secret-set) — set a [secret](/catalog/secret)
* [`murmur secret ls`](/cli/secret-ls) — list [secret](/catalog/secret) names
