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

> Delete a catalog resource by kind and name — refuses if other resources still reference it unless you pass an explicit force flag.

Deletes a [catalog](/catalog/overview) resource.

<Warning>
  This permanently removes the resource. There is no confirmation prompt and no undo.
</Warning>

## Synopsis

```bash theme={null}
murmur rm <kind> <name>
```

## Arguments

| Name   | Type   | Required | Description                                                                                                     |
| ------ | ------ | -------- | --------------------------------------------------------------------------------------------------------------- |
| `kind` | string | yes      | The [catalog](/catalog/overview) resource kind. Run [`murmur describe`](/cli/describe) to list available kinds. |
| `name` | string | yes      | The resource name to delete.                                                                                    |

## Examples

### Delete an environment

```bash theme={null}
murmur rm environment staging
```

```
Deleted environment "staging"
```

### Delete a secret

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

```
Deleted secret "NPM_TOKEN"
```

## Errors

| Code                  | Meaning                                                                                                                                                        | What to do                                                                         |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `NOT_FOUND`           | No resource with that kind and name exists.                                                                                                                    | Check the name. Run [`murmur get`](/cli/get) `<kind>` to list available resources. |
| `UNAUTHENTICATED`     | Identity token is missing or expired.                                                                                                                          | Run `murmur auth` or check your `murmur.local.yaml` configuration.                 |
| `FAILED_PRECONDITION` | Another resource references this one (e.g. a [workspace](/concepts/workspaces) references the [environment](/concepts/environments) you are trying to delete). | Remove or update the referencing resources first, then retry the delete.           |
| `PERMISSION_DENIED`   | The resource is a platform builtin and cannot be deleted.                                                                                                      | Platform-managed resources are immutable.                                          |

## Related

* [Catalog](/catalog/overview) -- concept overview
* [`murmur get`](/cli/get) -- read a resource or list resources of a kind
* [`murmur set`](/cli/set) -- create or fully replace a resource
* [`murmur patch`](/cli/patch) -- update individual fields on a resource
* [`murmur describe`](/cli/describe) -- show schema information for a kind