Skip to main content

Retry a webhook event

Retry delivery of a single webhook event. Use this endpoint to resend a previously delivered event or retry an event that failed or was skipped during processing.

If the webhook subscription is waiting for an automatic retry due to the target host being unavailable, wait for the retry delay to expire or resume the webhook subscription before retrying a failed or skipped event. Previously delivered events can be resent even while the subscription is delayed.

Request​

Endpoint​

POST https://api.woodpecker.co/rest/v2/webhooks/events/{id}/retry

Headers​

x-api-key: {YOUR_API_KEY}

For details on how to authenticate your requests, please see the authentication guide.

Parameters​

ParameterRequiredTypeDescription
idYesintegerEvent ID from the id field in webhook events

Request samples​

Resend a processed event​

curl --request POST \
--url "https://api.woodpecker.co/rest/v2/webhooks/events/12346/retry" \
--header "x-api-key: {YOUR_API_KEY}"

Response​

Response examples​

The failed or skipped event was queued for another processing attempt. Use Get webhook events to check its status.

Body: none