alerts-api---webhooks

Rotate signing secret

Issues a new current signing secret. By default the previous secrets stay valid for a 24-hour grace window so you can install the new key before removing the old one. Pass {"immediate": true} to revoke all previous secrets right away — use this only when a secret is compromised.

post/alerts-api/webhooks/rotate-secret

Request

  • Base URL: https://api.casafari.com
  • URL: https://api.casafari.com/alerts-api/webhooks/rotate-secret
  • Auth: HTTP bearer

Request body

immediateboolean

When false (default), the previous secrets keep working for a 24-hour grace window so you can switch the new secret before the old one stops signing; deliveries carry a signature for each active secret meanwhile. When true, the previous secrets are revoked immediately and only the new one signs — use this only when a secret is compromised.

Response

Successful Response

secretstring required

Changes

No recorded changes to this operation across all 1 revision of this API.