Actualizar webhook
PUT/webhooks/:id
Actualización parcial: solo se modifican los campos enviados. is_active = true reactiva un webhook desactivado (manual o automáticamente por fallos). Reactivar no reinicia failure_count: si el webhook se desactivó por 10 fallos, la siguiente entrega fallida lo vuelve a desactivar; el contador solo vuelve a 0 con una entrega exitosa. El secret no se modifica aquí (ver rotate-secret). Solo se admite PUT.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 500
Webhook actualizado
No autenticado
La empresa del usuario está inactiva. Se evalúa después de validar el cuerpo: si el cuerpo es inválido se responde antes 422, aunque el webhook no exista o la empresa 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."). Se evalúa después de validar el cuerpo: si el cuerpo es inválido se responde antes 422, aunque el webhook no exista o la empresa esté inactiva.
Datos inválidos. Los eventos no válidos se reportan por índice (errors["events.N"] = ["Uno o más tipos de evento no son válidos."]); un events vacío devuelve errors.events = ["Debe seleccionar al menos un tipo de evento."]; name no admite null ni cadena vacía. Un elemento nulo o vacío en events devuelve errors["events.N"] = ["El campo events.N es obligatorio cuando events está presente."]; un elemento que no es texto devuelve dos mensajes ("El campo events.N debe ser una cadena de caracteres." y "Uno o más tipos de evento no son válidos."); si events no es un array, errors.events = ["El campo events debe ser un array."] (con events null, cadena vacía o false se añade además "Debe seleccionar al menos un tipo de evento."); url null o vacía devuelve errors.url = ["La URL del webhook no es válida."]; is_active solo admite true/false/1/0: otro valor (incluido el texto "true") devuelve errors.is_active = ["El campo is active debe ser verdadero o falso."].
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. Este error se produce después de validar el cuerpo: con datos inválidos se responde antes 422. Envíe siempre un id numérico.