Rotate signing secret
BillionSend extension. Mints a new signing secret (or takes the one in signing_secret) and returns it. For overlap_hours the previous secret keeps signing too: every delivery in that window carries both signatures, space-separated in webhook-signature, so the receiver can switch at any point without a gap. A second rotation inside the window replaces the previous secret.
/webhooks/{id}/rotateAuthorizationBearer 令牌 · header必填A BillionSend API key (bs_…).
idstring<uuid>必填application/jsonsigning_secretstringNew secret to sign with: whsec_ followed by base64 of 24-64 bytes. Omit to mint one.
overlap_hoursintegerHours the previous secret keeps signing alongside the new one (default 24, max 72). Every delivery in the window carries both signatures, so a receiver holding either verifies; 0 drops the old secret at once.
The new secret and when the previous one stops signing
objectstring必填webhookidstring<uuid>必填signing_secretstring必填previous_secret_expires_atstring | null必填Missing, malformed, unknown or revoked API key
statusCodenumber必填namestring必填messagestring必填Not found
statusCodenumber必填namestring必填messagestring必填Validation error
statusCodenumber必填namestring必填messagestring必填Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumber必填namestring必填messagestring必填