Resend a delivery
POST/v1/deliveries/{deliveryId}/resendpreview
Queue one more delivery attempt. Use it for a delivery that is held, ran out of retries, or that your receiver says never arrived. Never resets the attempt history, so what was already tried stays visible. The attempt runs the transform the destination publishes now, or none if it was removed or never published, so publishing a fix recovers a delivery that failed on a transform bug. It goes out at once, even while the destination is cooling down or its circuit is open, unless another test attempt to the destination is already running. A 2xx ends the cooldown. One delivery can be resent once every 30 seconds; an earlier resend is refused with 429 and a Retry-After header. Refused with 409 while the delivery has an attempt in flight, or while its destination is paused for failing.
Path parameters
deliveryIdstring RequiredA delivery ID, starting with dlv_.
Returns
A new attempt was queued for the delivery.202
dataobject RequiredReceipt for one re-queued delivery. The delivery gains exactly one further attempt and keeps every attempt already recorded; it does not restart the retry schedule, so a delivery that has exhausted its retries fires once and settles.
deliveryIdstring RequiredThe delivery that was re-queued.
attemptNumbernumber RequiredThe attempt number this resend will make. One more than the attempts already recorded.
At least 1
Example
curl -X POST "https://api.payloadpuffin.com/v1/deliveries/$DELIVERYID/resend" \
-H "Authorization: Bearer $PAYLOADPUFFIN_API_KEY"{
"data": {
"deliveryId": "deliveryId",
"attemptNumber": 1
}
}Errors
Errors use application/problem+json. The code member is stable; branch on it rather than on title or detail.
4XXapplication/problem+jsonThe request was rejected.