POST/v1/webhook-deliveries/:id/replay

Replay a webhook delivery

Re-sends a previous webhook event to the original endpoint. Useful after fixing a bug in your handler or recovering from an outage.

A replay creates a new delivery (with its own whd_… ID and attempt = 1). The original delivery record is preserved.

Replay is naturally idempotent on Aeses's side, but we recommend sending an Idempotency-Key to protect against accidental client-side floods.

Parameters

stringRequired

Delivery ID to replay, in the path.

stringOptional

Override the destination URL. Defaults to the original delivery's endpoint. Useful when migrating to a new handler.

Returns

The newly created WebhookDelivery object with status: "pending".

Errors

Status	Code	Description
404	`not_found`	No delivery with that ID exists.
400	`invalid_endpoint_url`	`endpoint_url` is not a valid HTTPS URL.

Replay a delivery

curl -X POST https://api.aeses.io/v1/webhook-deliveries/whd_01HXZ12345ABCDEFGHJKMNPQRS/replay \
-H "x-api-key: sk_live_..." \
-H "Idempotency-Key: $(uuidgen)"

Response

{
"id": "whd_01HXZ99887ZYXWVUTSRQPONMLKJ",
"object": "webhook_delivery",
"event_id": "evt_01HXYZ...",
"event_type": "deposit.completed",
"endpoint_url": "https://example.com/webhooks/aeses",
"attempt": 1,
"status": "pending",
"response_status": null,
"response_body": null,
"next_attempt_at": null,
"created_at": 1731610000
}