Rotate webhook signing secret

Generates a new signing secret for the webhook endpoint. The previous secret is immediately invalidated.

POST /v1/webhook-endpoints/{endpoint_id}/rotate-secret

Rotate webhook signing secret

cURL

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

200

{
  "signing_secret": "<string>"
}

Authorizations

x-api-key · string · header · required

Path Parameters

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"

Response

200

application/json

Signing secret rotated successfully.

signing_secret · string · required

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