Rotar el signing secret

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

Reemplaza el signing secret y devuelve el nuevo valor una sola vez. Por defecto el secret anterior sigue firmando entregas durante 24 horas (previous_secret_grace_hours), periodo en el que cada entrega lleva una firma por secret, para que el receptor cambie de clave sin perder eventos. Envía 0 para revocar el secret anterior de inmediato (secret filtrado). Acepta tanto el UUID interno como el external_id del recurso.

Request

Responses

200

Nuevo signing secret (se muestra una sola vez).

401

Fallo de autenticación (JWT o mTLS ausente o inválido).

403

Autenticado, pero el scope es insuficiente o el recurso está fuera de alcance.

404

Recurso no encontrado o excluido por soft-delete.