Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-222763184.3 KB
webhooks

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.

post/webhooks/subscriptions/{subscription_id}/recover

Path parameters

subscription_idstring required

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

Example:550e8400-e29b-41d4-a716-446655440000

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

Request body

sincestring date-time required

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

untilstring date-time nullable

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

Example request

{
  "summary": "Recover last 24 hours",
  "value": {
    "since": "2024-03-14T00:00:00Z",
    "until": "2024-03-15T00:00:00Z"
  }
}

Response

Recovery task information

idstring required

Unique identifier for this recovery task (Svix internal ID)

statusstring required

Recovery task status: 'running' or 'completed'

Example response

{
  "id": "rcvr_2bVxUn3RFnLYHa8z6ZKHMT9PqPX",
  "status": "running"
}