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

# queue dlq

> Manage the dead letter queue — list, replay, and discard failed events.

The dead letter queue (DLQ) captures events that failed to process — webhook delivery failures, import errors, and more. Review them here and decide whether to retry or discard.

## moss queue dlq list

List events in the dead letter queue. Requires owner role.

```bash theme={null}
moss queue dlq list
moss queue dlq list --queue-name webhooks --status failed
```

| Option                | Required | Description                                                                       |
| --------------------- | -------- | --------------------------------------------------------------------------------- |
| `--page <n>`          | No       | Page number                                                                       |
| `--per-page <n>`      | No       | Items per page                                                                    |
| `--queue-name <name>` | No       | Filter by queue name (`webhooks`, `imports`, `exports`, `audit-fanout`, `digest`) |
| `--status <status>`   | No       | Filter by status                                                                  |

### JSON output

```bash theme={null}
moss queue dlq list --json
```

```json theme={null}
{
  "data": [
    {
      "id": "dlq_abc123",
      "queue_name": "webhooks",
      "status": "failed",
      "error_message": "Connection timeout to https://hooks.example.com/moss",
      "payload": { "event": "contact.created", "contact_id": "cnt_abc123" },
      "created_at": "2026-02-08T12:00:00Z"
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 3, "total_pages": 1 }
}
```

## moss queue dlq replay

Replay a failed DLQ event, re-adding it to the original queue for processing.

```bash theme={null}
moss queue dlq replay --id dlq_abc123
```

| Option      | Required | Description  |
| ----------- | -------- | ------------ |
| `--id <id>` | Yes      | DLQ event ID |

## moss queue dlq discard

Discard a DLQ event, marking it as resolved without reprocessing.

```bash theme={null}
moss queue dlq discard --id dlq_abc123
```

| Option      | Required | Description  |
| ----------- | -------- | ------------ |
| `--id <id>` | Yes      | DLQ event ID |