Rotacionar o signing secret

POST 
/v1/webhooks/:id/regenerate-secret

Substitui o signing secret e retorna o novo valor uma única vez. Por padrão o secret anterior continua assinando entregas por 24 horas (previous_secret_grace_hours), período em que cada entrega carrega uma assinatura por secret, para que o receptor troque a chave sem perder eventos. Informe 0 para revogar o secret anterior imediatamente (secret vazado). Aceita tanto o UUID interno quanto o external_id do recurso.

Request

Responses

200

Novo signing secret (exibido uma única vez).

401

Falha de autenticação (JWT ou mTLS ausente/inválido).

403

Autenticado, mas o escopo é insuficiente ou o recurso está fora de alcance.

404

Recurso não encontrado ou filtrado por soft-delete.