Webhooks

Rotate signing secret

Replaces the endpoint's secret. The new secret is returned exactly once. Requires a paid plan.

post/v2/organizations/{organizationId}/webhooks/{endpointId}/rotate-secret

Request

  • Base URL: https://api.pdfs.build
  • URL: https://api.pdfs.build/v2/organizations/{organizationId}/webhooks/{endpointId}/rotate-secret
  • Auth: HTTP bearer

Response

The endpoint and its new secret.

secretstring required

Standard Webhooks signing secret (whsec_ + base64). Shown once; store it now.

Example response

{
  "endpoint": {
    "id": "whe_5xg6Kq0PSTeK1bXf3eDR3w",
    "createdAt": "2026-08-30T12:00:00.123456",
    "updatedAt": "2026-08-30T12:00:00.123456"
  },
  "secret": "whsec_MfKjnR7bCq4Xy1UvZ0aW3sTdE9gHpLqI5oN2kBjA8xY="
}

Changes

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