v25

OpenAPI 3.1.0raw.githubusercontent.com2026-08-015486519.4 KB
Webhooks

Rotate a builder webhook signing secret

Rotates the endpoint signing secret and returns the new signing_secret once in the response. Returns 409 with error.reason=webhook_delivery_in_progress while a live delivery freezes the current signing nonce; retry after it completes.

post/api/v1/webhooks/{id}/rotate-secret

Path parameters

idinteger required

Webhook endpoint id owned by the authenticated API key user.

Headers

Idempotency-Keystring

Optional safe-retry key. Reuse the same value only when retrying the exact same mutation request body; a different body returns 422 and an in-flight matching request returns 409.

Response

Webhook destination

object'webhook' required