Docs
API referenceWorkspaceCredentials

Rotate webhook signing secret

Returns a new signing secret; store it securely. The previous secret remains valid for 24 hours. Rotating again immediately discards the oldest secret, keeping only the new secret and its most recent predecessor. Identical retries recover the encrypted receipt for 15 minutes without rotating again. Disabled endpoints remain disabled.

Endpoint
POST /v1/organization/webhook-endpoints/{endpointId}/rotate-secret
Authorization
Required permission: `apiKeys:manage`.
Environments
Production and sandbox
Idempotency
Required for safe retries.