Skip to main content
POST
/
v1
/
webhook-deliveries
/
{id}
/
retry
Retry a delivery
curl --request POST \
  --url https://api.scrip.dev/v1/webhook-deliveries/{id}/retry \
  --header 'X-API-Key: <api-key>'
{
  "attempt_count": 1,
  "created_at": "2026-01-15T10:30:00Z",
  "delivered_at": "2026-01-15T10:30:01Z",
  "event_type": "balance.credited",
  "id": "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
  "last_attempt_at": "2026-01-15T10:30:01Z",
  "last_error": "<string>",
  "last_response_body": "<string>",
  "last_response_status": 200,
  "max_attempts": 8,
  "next_attempt_at": "2026-01-15T10:30:00Z",
  "status": "DELIVERED",
  "updated_at": "2026-01-15T10:30:01Z",
  "webhook_endpoint_id": "550e8400-e29b-41d4-a716-446655440000",
  "webhook_event_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}
Resets a FAILED delivery back to PENDING with attempt_count reset to 0 and a fresh set of 8 retry attempts. The delivery is scheduled for immediate redelivery. Only deliveries in FAILED status can be retried. Attempting to retry a delivery in any other status returns 404 Not Found.
For the full retry schedule and response handling behavior, see the Webhooks guide — Retry Policy.

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header.

Path Parameters

​
id
string<uuid>
required

Delivery ID

Response

Reset delivery

​
attempt_count
integer

Number of delivery attempts made so far

Example:

1

​
created_at
string<date-time>

When the delivery record was created

Example:

"2026-01-15T10:30:00Z"

​
delivered_at
string<date-time>

When the delivery was successfully completed

Example:

"2026-01-15T10:30:01Z"

​
event_type
string

The event type (e.g. balance.credited)

Example:

"balance.credited"

​
id
string<uuid>

Delivery ID

Example:

"d1e2f3a4-b5c6-7890-abcd-ef1234567890"

​
last_attempt_at
string<date-time>

When the last attempt was made

Example:

"2026-01-15T10:30:01Z"

​
last_error
string

Error message from the last attempt (network errors, timeouts)

​
last_response_body
string

Response body from the last attempt (truncated to 4 KB)

​
last_response_status
integer

HTTP status code from the last attempt

Example:

200

​
max_attempts
integer

Maximum attempts before marking as FAILED

Example:

8

​
next_attempt_at
string<date-time>

When the next delivery attempt is scheduled

Example:

"2026-01-15T10:30:00Z"

​
status
string

Delivery status: PENDING, SENDING, DELIVERED, or FAILED

Example:

"DELIVERED"

​
updated_at
string<date-time>

When the delivery record was last updated

Example:

"2026-01-15T10:30:01Z"

​
webhook_endpoint_id
string<uuid>

The endpoint this delivery targets

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
webhook_event_id
string<uuid>

The webhook event that triggered this delivery

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"