Skip to main content
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. 
moss queue dlq list
moss queue dlq list --queue-name webhooks --status failed
OptionRequiredDescription
--page <n>NoPage number
--per-page <n>NoItems per page
--queue-name <name>NoFilter by queue name (webhooks, imports, exports, audit-fanout, digest)
--status <status>NoFilter by status

​
JSON output

moss queue dlq list --json

{
  "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. 
moss queue dlq replay --id dlq_abc123
OptionRequiredDescription
--id <id>YesDLQ event ID

​
moss queue dlq discard

Discard a DLQ event, marking it as resolved without reprocessing. 
moss queue dlq discard --id dlq_abc123
OptionRequiredDescription
--id <id>YesDLQ event ID