> ## 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 queue remove CLI command

> Remove one specific undelivered follow-up message by its follow-up ID — whether still pending its deferred delivery or already queued.

Removes one specific undelivered follow-up from an [agent's](/concepts/agents) queue by its follow-up ID (printed by [`murmur queue add`](/cli/queue-add)) — whether still pending its `--deliver-at` delay or already queued. Idempotent: reports whether anything was removed.

Cancelling a self-scheduled deferred follow-up (a "resume me at T" the agent no longer needs) is `queue remove` of that message.

## Synopsis

```bash theme={null}
murmur queue remove [flags] <slug> <follow-up-id>
```

## Arguments

| Name           | Type   | Required | Description                                             |
| -------------- | ------ | -------- | ------------------------------------------------------- |
| `slug`         | string | yes      | The agent's slug.                                       |
| `follow-up-id` | string | yes      | The follow-up ID `queue add` printed for the message.   |
| `--json`       | bool   | no       | Output the QueueRemoveResponse as JSON.                 |
| `--workspace`  | string | no       | Workspace name. Overrides the value from `murmur.yaml`. |

## Output

```
follow-up removed
```

or, when the message was already delivered, already removed, or never queued:

```
no undelivered follow-up with that ID
```

## Errors

| Code                  | Meaning                                                                  | What to do                                  |
| --------------------- | ------------------------------------------------------------------------ | ------------------------------------------- |
| `FAILED_PRECONDITION` | The agent is pinned to a pre-182 build without the queue-remove handler. | Upgrade the agent with `murmur can`.        |
| `NOT_FOUND`           | The agent is not running.                                                | Check the slug with [`murmur ls`](/cli/ls). |

## Related

* [`murmur queue add`](/cli/queue-add) — send or defer a follow-up (prints the follow-up ID)
* [`murmur queue clear`](/cli/queue-clear) — discard ALL queued and deferred follow-ups
* [`clear_queue`](/mcp-server/clear-queue) — equivalent MCP tool (with `follow_up_id`)