Rotate the signing secret. The new one is in this answer and nowhere else, ever
For expires_in seconds every message is signed with BOTH secrets (two signatures in webhook-signature), so the receiver can switch without losing a message; 0 retires the previous secret at once (use it for a leaked secret). Only two secrets sign at a time: rotating again inside the window retires the oldest immediately. A retry with the same Idempotency-Key does not rotate again and returns secret: null.
POST
https://api.invox.page/v1/webhook_endpoints/{id}/rotate_secretAuthorization
Path parameters
Header parameters
Request body JSON required
Returns
200
A retry: the destination, without the secret.
JSON
201
The destination, with its new secret.
JSON
400
organization_required: This credential needs to say which organization it acts on · validation_failed: The request is not valid · malformed_request: The request body is not valid JSON · idempotency_key_required: This write needs an Idempotency-Key header
JSON
401
unauthenticated: No credential was sent · invalid_credential: The credential is not valid
JSON
403
missing_scope: The credential lacks the permission this operation requires · organization_mismatch: The X-Organization header names another organization than the key's · organization_archived: The organization is archived
JSON
404
not_found: The resource does not exist in this organization · webhook_endpoint_not_found: The webhook destination does not exist in this organization
JSON
422
idempotency_key_reused: This Idempotency-Key was already used with a different request
JSON
429
rate_limited: Too many requests
JSON
500
internal_error: The service failed
JSON
503
service_unavailable: The service cannot answer right now
JSON