Skip to content
RateStack
API cookbook

Replay a webhook DLQ entry

When a subscriber goes down, deliveries land in DLQ. Replay them safely with the rate-limited replay endpoint.

RTBy RateStack TeamPublishedReviewed
beginnercURL · Bash

List the DLQ

curl -fsS -H "X-API-Key: $KEY" \
  https://api.ratestack.com/internal/v1/dlq?limit=50 | jq .

Replay one

DLQ_ID="dlq_8a7c4f"
curl -fsS -X POST -H "X-API-Key: $KEY" \
  https://api.ratestack.com/internal/v1/dlq/$DLQ_ID/replay

Replay creates a fresh delivery row with attempt=0 and dispatches it through the regular pipeline. The replay endpoint is rate-limited via in-memory bucket4j to protect downstream subscribers from a stampede.

Replay a window

# Replay all DLQ entries from a given subscription within a 1-hour window
curl -fsS -H "X-API-Key: $KEY" \
  "https://api.ratestack.com/internal/v1/dlq?subscriptionId=$SUB&since=2026-04-01T08:00:00Z&until=2026-04-01T09:00:00Z" \
  | jq -r '.items[].id' \
  | xargs -I {} curl -fsS -X POST -H "X-API-Key: $KEY" \
      https://api.ratestack.com/internal/v1/dlq/{}/replay
All recipes
Replay a webhook DLQ entry — API cookbook | RateStack