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

Authorizationrequiredheaderstring

A project secret key (sk_test_… or sk_live_…) sent as Authorization: Bearer <key>. Server to server only.

Path parameters

idrequiredpathstring

The webhook endpoint.

Body

overlap_secondsinteger

How long the old secret still signs next to the new one. Default 86400 (one day), 0 drops it now, at most 604800.

StatusBody
200WebhookEndpointWithSecret
400, 401, 404Error