Rotate webhook signing secret
POST/api/webhooks/:id
x-audience: "management"
x-required-scope: "webhooks:admin"
Rotates the endpoint signing secret. The new secret is returned once. Accepted messages continue to use their pinned signing-key version.
Request
Responses
- 200
- 401
- 403
- 404
- 429
- 503
Success
Missing, invalid or revoked credentials.
Required scope or account access missing.
Endpoint not found.
Shared client-IP or account request allowance exhausted. Retry after the indicated number of seconds. Browser authentication errors can use a different response format.
Response Headers
Cache-Control
no-store
Retry-After
Seconds to wait before retrying.
Secret encryption unavailable. Shared request limiting can also return 503 rate_limit_unavailable with Cache-Control: no-store.
Response Headers
Cache-Control
Request limiter responses use no-store.