SapanBaseDevelopers

Rotate the signing secret

Mints a new signing secret, returned ONCE. The old secret is invalid immediately — queued retries are re-signed with the new one.

POSThttps://api.helpbento.com/v1/webhooks/{id}/rotate-secret

Authentication

AuthorizationstringheaderBearer <token>required

An API key, e.g. hb_live_… (live) or hb_test_… (test).

Path parameters

1 param
  • idstringrequired

Header parameters

1 param
  • Idempotency-Keystringlength: 0…255

    Optional idempotency key (1–255 chars). Repeating a mutating request with the same key within 24h replays the original response instead of re-executing it; a concurrent in-flight request with the same key returns 409. Use a unique key (e.g. a UUID) per logical operation so network retries are safe.

Responses

  • idstring
  • urlstringuri
  • eventsarray of string
  • statusstringactive | disabled
  • createdAtstringdate-time
  • signingSecretstring

    Shown once. Verify the X-HelpBento-Signature header with it.

Errors