Sign inGet Started

Rotate callback signing secret

POST
/v1/webhook-callbacks/rotate-signing-secret
bird webhooks callbacks rotate-signing-secret --yes
प्रतिक्रिया200
{
  "secret": "whsec_newbase64encodedvalue"
}

Generates a new signing secret for the workspace's SMS callback URLs and returns it exactly once: store it immediately, it cannot be retrieved after this response. The secret is shared by every callback URL in the workspace. For 24 hours deliveries are signed with both the old and the new secret, then the old one stops signing.

A workspace holds at most 5 concurrently valid secrets, so rotating repeatedly within the overlap window fails with WebhookTooManySecrets until an older secret expires.

Response Payload

secret
string
आवश्यक

The new signing secret (whsec_ prefix). Shown only in this response: store it immediately, it cannot be retrieved again. Deliveries are signed with both this and the previous secret for 24 hours after rotation, then the previous secret stops signing.

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।