Webhooks

Rotate a webhook secret

Makes a new signing secret and returns it, shown only here. For 24 hours the old secret signs too, as a second signature in webhook-signature, so you can deploy the new one without dropping events. Rotating again within those 24 hours drops the oldest.

Needs an API key with the generations:write scope.

post/v1/webhook_endpoints/{id}/rotate_secret

Request

  • Base URL: https://api.tryleap.ai
  • URL: https://api.tryleap.ai/v1/webhook_endpoints/{id}/rotate_secret
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

idstring required

The endpoint's ID, we_....

Response

The endpoint, with its new signing secret.

idstring required

The endpoint's ID, we_....

object'webhook_endpoint' required
urlstring required

Where Leap POSTs events.

descriptionstring nullable required

Your note, if any.

eventsstring[] required

The event types it gets; ["*"] for every type, including types added later.

disabledboolean required

Whether deliveries to it are stopped.

disabled_reasonstring nullable required

Why Leap disabled the endpoint, such as every delivery failing for 72 hours; null when it is on or you turned it off.

created_atstring date-time required

When it was created.

updated_atstring date-time required

When it last changed.

secretstring required

The signing secret, whsec_ and base64. Shown only here: keep it in your server's environment.

Changes

No recorded changes to this operation across all 1 revision of this API.