Rotar secret del webhook
POST/webhooks/:id/rotate-secret
Genera un nuevo secret (40 caracteres alfanuméricos) para firmar las entregas y lo retorna. Es la única respuesta que expone el secret: guárdelo en ese momento. El secret anterior deja de usarse de inmediato. No recibe cuerpo. Verificación en el receptor: calcular HMAC-SHA256 (hex) del cuerpo crudo recibido con el secret y compararlo con el valor v1 de la cabecera X-Webhook-Sig.
Request
Responses
- 200
- 401
- 403
- 404
- 500
Nuevo secret generado
No autenticado
La empresa del usuario está inactiva
El webhook no existe, fue eliminado o pertenece a otra empresa (message "Webhook endpoint not found."), o el usuario no tiene una empresa asociada (message "No se encontró la empresa asociada al usuario.")
El id de la ruta no es numérico (por ejemplo abc o 1abc): el servidor responde un error genérico {"message": "Server Error"} sin el campo success (o una página HTML si la petición no envía Accept: application/json), no un 404. Envíe siempre un id numérico.