Dead Letter Queue

Inspect and manage failed webhook deliveries.

List DLQ Entries

GET /dlq

Returns all entries in the dead letter queue.

Response 200 OK

[
  {
    "message_id": "msg-123",
    "webhook_url": "https://yourapp.com/webhook",
    "failed_at": "2025-03-19T12:00:00Z",
    "reason": "connection refused"
  }
]

Returns an empty array [] if the DLQ is empty or not configured.

Remove DLQ Entry

DELETE /dlq/{id}

Remove an entry from the dead letter queue after it has been handled.

Parameters

Parameter	In	Type	Required	Description
id	path	string	Yes	Message ID of the DLQ entry

Response 204 No Content

Errors

Status	Reason
401	Invalid or missing API key
404	Entry not found

DLQ Entry Object

Field	Type	Description
message_id	string	ID of the failed message
webhook_url	string	The webhook URL that failed
failed_at	string (ISO 8601)	When the final delivery attempt failed
reason	string	Human-readable failure reason

Related

• Replay a message to re-attempt delivery
• DLQ guide for operational best practices