Skip to main content
POST
Requeues webhook deliveries for retry. With a deliveryId, requeues that specific delivery regardless of its status; without one, requeues all FAILED deliveries for the endpoint. Requeued deliveries are only attempted while the endpoint is ACTIVE — when recovering from auto-disable, re-enable first, then redeliver. Requirements: webhooks:manage scope.

Request

endpointId
string
required
The webhook endpoint ID.
deliveryId
string
A specific delivery to requeue — the value of the X-OpenTrain-Delivery header. Omit to requeue every FAILED delivery on the endpoint.

Response

webhookEndpoint
object
The endpoint: {id, url, eventTypes, status, createdAt, consecutiveFailures, disabledAt, disabledReason} — same shape as GET /webhook-endpoints/{endpointId}.
requeued
integer
How many deliveries were requeued.
message
string
When the requeued deliveries will be attempted — or a reminder that nothing is attempted while the endpoint is DISABLED.

Errors

StatuscodeMeaning
400BAD_REQUESTBody not valid JSON
401UNAUTHORIZEDMissing, invalid, or revoked token
403FORBIDDENToken lacks webhooks:manage
404NOT_FOUNDEndpoint or delivery not found on this install