Webhooks
Rotate a webhook signing secret
A new signing secret, in the answer and only there. For 24 hours each delivery carries two signatures in webhook-signature, one with each secret, so the receiver can switch without losing any; then only the new one.
post/webhooks/{id}/rotate-secret
Request
- Base URLhttps://api.rizamo.com/v1
- AuthHTTP bearer
Path parameters
idstring required
The webhook endpoint's id (wh_).
Headers
Idempotency-Keystring
1 to 255 printable characters, new for each request (a UUID); the body up to 1 MB. For 24 hours a repeat with the same key, path and body gets the first answer, with Idempotent-Replayed: true, instead of running again; 5xx, 409 and 429 answers are not kept. Errors, Retries, has the rest.
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.