API reference
Rotate a webhook secret
Dashboard
BetaWe just launched Apps: hosted models, actions and pages, on the same bill as your inference.Read the Apps docs

Rotate a webhook secret

POSThttps://api.inferencebureau.com/v1/webhooks/{id}/rotate

A new signing secret, in this response only. For the overlap, every delivery's IB-Signature carries a signature with the old secret too, so a receiver keeps accepting deliveries while it switches to the new one.

Path

  • idstringrequired

    The endpoint's id.

Body

application/json, optional
  • overlap_secondsintegeroptional

    How long the old secret keeps signing: 0 to 604800 (7 days), default 86400. 0 drops it now. A secret from an earlier rotation stops signing either way.

Response

  • secretstringrequired

    The new whsec_… secret, shown once.

  • previous_secret_expires_atstring | nullrequired

    When the old secret stops signing; null with an overlap of 0.

Notes

  • Auditoptional

    One webhook.rotate_secret event; the secrets themselves are never logged.