Skip to main content

Issue a new signing secret; the previous one keeps signing for 24 h

POST 

/v1/webhooks/:webhook_id:rotate_secret

At most two secrets are live. While the previous secret is still in its 24-hour overlap the call answers 409 secret_rotation_in_progress (details.previous_secret_expires_at), unless you send expire_previous_now: true: the older secret is then destroyed at once and the current one becomes the previous one (the way back after a lost rotation response). No Idempotency-Key replay: secrets are never stored in a replayable form.

Access: API key scope webhooks:write on a management key; portal users: organization admins and owners; refused for an API key limited to a list of knowledge bases (403 kb_not_in_allowlist).

Request​

Responses​

New secret (shown once).