> ## 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 subscriptions flush

> Remove all event subscriptions for an agent — useful for stopping notifications when an agent should no longer react to repository activity.

Removes every [event](/concepts/events) subscription for an [agent](/concepts/agents) — all branch subscriptions, all file subscriptions, and all child subscriptions. After flushing, the [agent](/concepts/agents) receives no [events](/concepts/events) until new subscriptions are added with [`murmur subscriptions add`](/cli/subscriptions-add).

## Synopsis

```bash theme={null}
murmur subscriptions flush [flags] [slug]
```

On a VM, the slug is optional — omitting it flushes the current [agent](/concepts/agents)'s subscriptions.

## Arguments

| Name          | Type   | Required  | Description                                                                     |
| ------------- | ------ | --------- | ------------------------------------------------------------------------------- |
| `slug`        | string | on laptop | The [agent](/concepts/agents)'s slug. Optional on VMs (defaults to self).       |
| `--workspace` | string | no        | [Workspace](/concepts/workspaces) name. Overrides the value from `murmur.yaml`. |

## Examples

### Flush all subscriptions

```bash theme={null}
murmur subscriptions flush fix-auth
```

```
flushed all subscriptions for fix-auth
```

### Self-flush on a VM

When running on an [agent](/concepts/agents) VM, omit the slug:

```bash theme={null}
murmur subscriptions flush
```

```
flushed all subscriptions for self
```

## Errors

| Code               | Meaning                                             | What to do                                                                                     |
| ------------------ | --------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `INVALID_ARGUMENT` | Slug is required when not running on a VM.          | Provide the [agent](/concepts/agents) slug as a positional argument.                           |
| `NOT_FOUND`        | No [agent](/concepts/agents) with that slug exists. | Check the slug spelling. Use [`murmur ls`](/cli/ls) to see running [agents](/concepts/agents). |
| `UNAUTHENTICATED`  | Identity token is missing or expired.               | Run `murmur auth` or check your `murmur.local.yaml` configuration.                             |

## Related

* [Events](/concepts/events) — concept overview
* [Agents](/concepts/agents) — concept overview
* [`murmur subscriptions add`](/cli/subscriptions-add) — subscribe to branch or file [events](/concepts/events)
* [`murmur subscriptions remove`](/cli/subscriptions-remove) — unsubscribe from specific [events](/concepts/events)
* [`murmur subscriptions ls`](/cli/subscriptions-ls) — list an [agent](/concepts/agents)'s subscriptions