Skip to main content
POST
/
api
/
partner
/
v1
/
webhook-endpoints
/
{endpointId}
/
redeliver
curl -sS -X POST https://app.opentrain.ai/api/partner/v1/webhook-endpoints/<ENDPOINT_ID>/redeliver \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "webhookEndpoint": {
    "id": "<ENDPOINT_ID>",
    "url": "https://your-platform.example.com/webhooks/opentrain",
    "eventTypes": ["contract.started", "contract.ended"],
    "status": "ACTIVE",
    "createdAt": "2026-06-12T10:00:00.000Z",
    "consecutiveFailures": 0,
    "disabledAt": null,
    "disabledReason": null
  },
  "requeued": 3,
  "message": "Requeued deliveries will be attempted on the next delivery run (within ~5 minutes)."
}
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
curl -sS -X POST https://app.opentrain.ai/api/partner/v1/webhook-endpoints/<ENDPOINT_ID>/redeliver \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "webhookEndpoint": {
    "id": "<ENDPOINT_ID>",
    "url": "https://your-platform.example.com/webhooks/opentrain",
    "eventTypes": ["contract.started", "contract.ended"],
    "status": "ACTIVE",
    "createdAt": "2026-06-12T10:00:00.000Z",
    "consecutiveFailures": 0,
    "disabledAt": null,
    "disabledReason": null
  },
  "requeued": 3,
  "message": "Requeued deliveries will be attempted on the next delivery run (within ~5 minutes)."
}