Rotate webhook signing secret

POST

webhook-endpoints

{endpoint_id}

rotate-secret

curl --request POST \
  --url https://api.us.poly.ai/v1/webhook-endpoints/{endpoint_id}/rotate-secret \
  --header 'x-api-key: <api-key>'

{
  "signing_secret": "<string>"
}

x-api-key

string

header

required

endpoint_id

string

required

The endpoint_id must be a prefixed ID (e.g. whe_9ZtRcXw3nByK5pVqMaEfJs).

Pattern: ^whe_[A-Za-z0-9]+$

Example:

"whe_9ZtRcXw3nByK5pVqMaEfJs"

Signing secret rotated successfully.

signing_secret

string

required

The new signing secret. Store it securely — it cannot be retrieved again.

Last modified on March 24, 2026

⌘I

Rotate webhook signing secret

curl --request POST \
  --url https://api.us.poly.ai/v1/webhook-endpoints/{endpoint_id}/rotate-secret \
  --header 'x-api-key: <api-key>'

{
  "signing_secret": "<string>"
}