Retries

A retry is a repetition of a previously attempted delivery. Retries can be triggered manually on any event, or automatically on failed events.

Retries

Once an attempt succeeds, further automatic retries on that event are disabled.

Events are limited to 50 automatic retries, but can be manually retried as many times as you like.

Manually retry events

Manually retrying events allows you to re-attempt delivery to a destination.

Manual retries are useful when troubleshooting, testing, or after resolving an issue on the destination. If a manual retry is successful, any further automatic retries on that event will be canceled – otherwise, future retries will continue as planned.

Manual retries can be triggered individually or in bulk.

Retry a single event

  1. Locate the event you wish to retry and click it to select it.
  2. In the right-hand panel that appears, click Retry.
POST /events/:id/retry

Hookdeck will now attempt to deliver the event to its destination. If it succeeds, any scheduled automatic retries for that event will be canceled.

Retry many events

Bulk retrying events may impact your delivery latency, as retries are queued alongside new events.

  1. Locate a list of events you wish to retry, either by filtering your event list or opening a custom event view.
  2. Click Bulk Retry.
  3. Click Retry All.
  4. Optional: If you need to cancel a bulk retry, click Bulk Retry, click the Ongoing tab, select the retry you'd like to cancel, and click Cancel.
POST /bulk/requests/retry

Hookdeck will now attempt to deliver the events. For each event whose delivery succeeds, any scheduled automatic retries will be canceled.

Automatically retry events

With automatic retries, Hookdeck will continue to attempt delivery for failed events.

Each automatic retry is counted as a new attempt. Once an attempt succeeds, further automatic retries on that event are canceled.

Events are limited to 50 automatic retries, but can still be manually retried after that limit is hit.

Configuring automatic retries

Configure a connection's automatic retries by setting its retry rule. There you can define the number of automatic retries Hookdeck will attempt after an event fails, the time interval between each attempt, and the retry strategy.

The retry strategy can be either linear or exponential. With a linear strategy, retries occur at regular intervals; with an exponential strategy, each retry is delayed twice as long as the previous (1 hour, 2 hours, 4 hours, etc.).

Viewing the next attempt

To determine when a specific event will be retried, locate the event and note its Next Attempt At property.

Cancel scheduled retries

Canceling an automatic retry will prevent all future scheduled retries from occurring on an event.

  1. Locate the event whose automatic retries you wish to cancel.
  2. On the event, click X to cancel the retry.
PUT /events/:id/mute