Retry failed delivery

Queue a fresh ladder of attempts for a delivery that has not been delivered: one with status "failed", or a "pending" one that no worker is holding. The attempt numbering continues after the attempts already spent (the delivery's attempts is never reset and its max_attempts is set to attempts plus one ladder of six, as GET /api/v1/webhook-deliveries/{id} then shows; a delivery an earlier version of this endpoint had reset to attempts: 0 resumes above its max_attempts), so a retried attempt never reuses the X-Webhook-Id of an attempt its attempts count already includes. A "pending" delivery that a queued job already holds is answered 200 ("already queued") instead of being given a second job.

post/api/v1/webhook-deliveries/{id}/retry

Request

Base URL: https://api.proof.holdings
URL: https://api.proof.holdings/api/v1/webhook-deliveries/{id}/retry
Auth: HTTP bearer

Path parameters

idstring required

MongoDB ObjectId

Example:507f1f77bcf86cd799439011

Response

Delivery retry initiated

successboolean required

messagestring required

delivery_idstring required

MongoDB ObjectId

next_retry_atstring date-time required

Example response

{
  "success": true,
  "message": "Webhook delivery queued for retry",
  "delivery_id": "507f1f77bcf86cd799439011"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.