At times, your API may fail to process a request. This could be due to a bug in your code, a temporary issue with a third-party service, or even network issues. QStash automatically retries messages that fail due to a temporary issue but eventually stops and moves the message to a dead letter queue to be handled manually. Read more about retries here.

How to Use the Dead Letter Queue

You can manually republish messages from the dead letter queue in the console.
  1. Retry - Republish the message and remove it from the dead letter queue. Republished messages are just like any other message and will be retried automatically if they fail.
  2. Delete - Delete the message from the dead letter queue.

Limitations

Dead letter queues are subject only to a retention period that depends on your plan. Messages are deleted when their retention period expires. See the “Max DLQ Retention” row on the QStash Pricing page.