Skip to main content
post/webhooks/signing-keys/rotate

Rotate the webhook signing key

LLM
View as Markdown
Open llms.txt

Generates a new signing key for webhook deliveries and demotes the previous active key to "expiring" with a 24h overlap. During the overlap, both keys are valid signers; receivers can update at their own pace. Returns the plaintext of the newly-generated key exactly once.

Authorization

Scheme

  • bearerAuth

Required scopes

  • webhook:update

Allowed roles

  • owner
  • admin

Rotate a webhook signing key.

Responses

  • 200

    New key generated; plaintext returned exactly once

    • application/json RotateWebhookSigningKeyResponse
  • default

    Error

    • application/json ProblemDetails