Skip to main content
POST
Rotate the webhook secret for an organization
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. A public v1 replacement is not currently listed in the v1 reference. This endpoint remains available for existing integrations until then.
Rotates the active webhook signing secret. After rotation, update every webhook receiver that validates x-dialnexa-signature.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-organization-id
string
required

RSA encrypted organization ID (base64 format)

Example:

"BASE64_ENCRYPTED_ORG_ID_HERE"

Body

application/json
name
string

Optional name for the new webhook secret

Example:

"Production Secret"

Response

The secret has been successfully rotated.