Rotate a signing secret Beta
Get a new secret, keep the old one for a while
Beta. This endpoint is live for design partners, with keys that Dopl issues while the developer portal is being built.
POST /v1/webhook_endpoints/{id}/rotate_secret
While both secrets are live, each POST carries two signatures. A check with either secret passes.
Authorizations
AuthorizationA project secret key (sk_test_… or sk_live_…) sent as Authorization: Bearer <key>. Server to server only.
Path parameters
idThe webhook endpoint.
Body
overlap_secondsHow long the old secret still signs next to the new one. Default 86400 (one day), 0 drops it now, at most 604800.
| Status | Body |
|---|---|
200 | WebhookEndpointWithSecret |
400, 401, 404 | Error |