Saltar al contenido principal
Usa este endpoint para modificar un webhook existente. Puedes actualizar la URL de callback, cambiar el estado para desactivar o volver a activar la entrega, o ambas cosas al mismo tiempo. El webhookId se envía como parámetro de ruta de la URL. Los cambios surten efecto de inmediato: desactivar un webhook detiene la entrega de eventos hasta que lo vuelvas a activar. Los eventos que ocurren mientras el webhook está desactivado no se ponen en cola y no se envían después de que lo vuelvas a activar. Un webhook eliminado no se puede actualizar.
Todas las solicitudes deben incluir el encabezado X-BH-TOKEN y Content-Type: application/json.

Endpoint

PUT https://api.velafi.com/v2/webhook/{webhookId}

Parámetro de ruta

string
requerido
ID único del webhook que se actualizará. Lo obtienes de la respuesta de Crear webhook o de Listar webhooks.

Parámetros de la solicitud

string
Opcional. La nueva URL de callback de este webhook. Debe comenzar con http. Si se omite, la URL no cambia.
number
Opcional. Estado actualizado del webhook: 10 = activo, 20 = desactivado. 30 se rechaza; usa Eliminar webhook en su lugar. Si se omite, el estado no cambia.

Campos de la respuesta

number
Código de respuesta de tipo HTTP. 200 indica éxito.
string
Mensaje de estado legible, por ejemplo SUCCESS.
object

Ejemplo

cURL
Respuesta
No puedes cambiar el eventType de un webhook existente. Para escuchar otro evento, crea un webhook nuevo y elimina el anterior.