Rotacionar o segredo de assinatura
Gera um novo segredo de assinatura de webhook, o retorna exatamente uma vez, o persiste como o segredo atual e rebaixa o segredo anterior com uma sobreposição (overlap) de 24 horas durante a qual ambos permanecem válidos para verificação. A entrega assina com o segredo atual. Uma assinatura sem segredo de assinatura em repouso (um sink pull) retorna 422 no_secret_to_rotate.
Autorizações
Um JWT bearer emitido pelo plugin-auth (lib-auth). A identidade do tenant é resolvida a partir das claims validadas do token; a superfície /v1 nunca lê um tenant do corpo, do path ou da query. Chamadores de máquina obtêm um token via o fluxo client-credentials do plugin-auth. A superfície /admin autoriza contra um escopo de operador e não carrega contexto de tenant.
Cabeçalhos
A client-chosen unique key that makes this mutation at-most-once. A mutation sent without it is rejected before any write with 400 missing_idempotency_key. Reusing the same key with an identical request replays the original response byte-for-byte (with X-Idempotency-Replayed: true); reusing it with a different request body returns 409 idempotency_conflict. To re-drive a corrected request, mint a new key.
Parâmetros de caminho
The unique identifier of the subscription (UUIDv7).
Resposta
Um novo segredo de assinatura foi gerado. O signingSecret é exibido exatamente uma vez — salve-o ao recebê-lo.
The new one-time signing secret (write-only). Shown exactly once here.
"whsec_1a2b3c4d5e6f7081a2b3c4d5e6f70819"
The moment the previous secret stops being valid for verification (UTC, RFC 3339) — a 24-hour dual-sign overlap.
"2026-06-06T12:00:00Z"

