API ReferenceWebhooks

Recover Failed Messages

Retry failed message deliveries for a webhook subscription. Triggers a recovery process that replays all failed messages within the specified time window. This is useful when: - Your endpoint was temporarily down and you want to catch up - You've fixed a bug in your webhook handler - You want to reprocess events after re-enabling a disabled subscription Messages are retried in chronological order. Successfully delivered messages are skipped; only failed or pending messages are retried.

Authentication

x-api-keystring
API Key authentication via header

Path parameters

subscription_idstringRequired

The unique identifier of the subscription to recover messages for (UUID).

Request

This endpoint expects an object.
sincestringRequiredformat: "date-time"

Start of the recovery time window (inclusive). All failed messages from this time onward will be retried.

untilstring or nullOptionalformat: "date-time"

End of the recovery time window (exclusive). If not specified, recovers all failed messages up to now.

Response

Recovery task information
idstring

Unique identifier for this recovery task (Svix internal ID)

statusstring

Recovery task status: ‘running’ or ‘completed’

Errors