Jobs

Rotate job webhook signing secret

Rotates the webhook's signing secret with zero downtime. The previous secret remains valid for a grace window so both old and new x-hires-signature-v2 signatures are accepted while you switch over.

post/jobs/{id}/webhooks/{webhook_id}/rotate-secret

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/jobs/{id}/webhooks/{webhook_id}/rotate-secret
  • Auth: HTTP bearer

Path parameters

idstring required

Job ID (numeric) or alias

webhook_idinteger required

Webhook subscription ID.

Response

New signing secret (the previous one stays valid for a grace window).

idinteger

Unique identifier

urlstring

Endpoint URL that receives webhook event payloads

signing_secretstring

HMAC-SHA256 signing secret for this webhook, used to verify the x-hires-signature-v2 header. Returned ONLY in create and rotate-secret responses — store it securely, it is never shown again.

Changes

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