Skip to content

Rotate a webhook signing secret

Request

Generate a new signing secret. It is returned ONCE in this response and never again.

Security
ApiKeyAuth
Path
idstringrequired
Headers
Idempotency-Keystring, <= 255 characters

Optional opaque key (e.g. a UUID) to make this write safely retryable. A replay with the same key returns the original response instead of repeating the side effect.

curl -i -X POST \
  'https://api.pioneerft.com/api/public/v1/webhook-endpoints/{id}/rotate-secret' \
  -H 'Authorization: Bearer <YOUR_API Key_HERE>' \
  -H 'Idempotency-Key: string'

Responses

New signing secret (shown once)

Bodyapplication/json
dataobject
Response
{ "data": { "secret": "string" } }