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.