Send a test delivery to your endpoint for a specific subscription. Useful for verifying
connectivity and confirming your server handles payloads correctly. Each ping gets a new trigger_id.
| Name | Type | Description |
|---|---|---|
| id Required | integer | Unique webhook identifier. |
| subscription_id Required | integer | Unique subscription identifier. |
No request body is required. WindBorne sends the signed ping immediately and returns
204 No Content when your endpoint accepts it. When the webhook is manually paused or the subscription is inactive, the endpoint
returns 422 Unprocessable Content. An automatically paused webhook can be reactivated by a successful ping.
When the subscription is not currently eligible for delivery, the endpoint
returns 403 Forbidden. Calculated-product pings only inspect products
calculated or published during the previous three days; when none matches the subscription's
filters, the endpoint also returns 422. When WindBorne cannot prepare or complete the test delivery, the endpoint returns
502 Bad Gateway. The payload also includes webhook_note or
subscription_note when those optional notes are configured.
When the subscription has response_options, the ping selects recent compatible
forecast data and performs the real enrichment before delivery. This validates the same
data.response shape and fetch behavior as an operational trigger.
Use the Calculation Times endpoint to inspect historical degree-day or tropical-cyclone availability beyond the ping window.
For tropical_cyclones.available and degree_days.available, the paired
response option inherits the system event's model and initialization time; it does not accept
a model.
A tropical_cyclones.available ping includes the base
data.tropical_cyclone_ids array for the model run even when no response
option is configured.
If enrichment fails, the ping fails without sending a partial payload.