Webhooks
Rotate the signing secret
Generates a fresh signing secret and returns it ONCE. The old secret is immediately invalidated — the next event delivery is signed with the new secret. Store the new value securely; it cannot be retrieved later.
Supply an Idempotency-Key header to safely retry on network errors — replays under the same key return the original rotation response rather than minting a fresh secret. Replays against a different public_id under the same key return 409 idempotency_conflict.
POST
Rotate the signing secret
Authorizations
Headers
Rotate the signing secret