Webhooks

Suscribe un endpoint HTTPS a eventos del workspace (por ejemplo, cuando se completa una agent run). Las entregas son durables: se reintentan ante fallos y se registran, así que no tienes que hacer polling.

Registrar un webhook

POST/v1/workspaces/{workspace_id}/webhooks —

body: url (obligatorio, tu receptor HTTPS), events (qué eventos enviar) y una description.

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/webhooks \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/hooks/nexevo", "events": ["agent.completed"]}'

Gestión y depuración

GET/v1/workspaces/{workspace_id}/webhooks —

PATCH/v1/workspaces/{workspace_id}/webhooks/{webhook_id} —

DELETE/v1/workspaces/{workspace_id}/webhooks/{webhook_id} —

lista, actualiza (rotar URL, cambiar events, enabled) y elimina.

POST/v1/workspaces/{workspace_id}/webhooks/{webhook_id}/test —

envía una entrega de prueba.

GET/v1/workspaces/{workspace_id}/webhooks/{webhook_id}/deliveries —

entregas recientes y su estado, para depuración.

Las entregas se persisten y reintentan (sobreviven a un reinicio), así que una interrupción transitoria por tu parte no perderá un evento. Verifica la firma en cada entrega y responde 2xx rápido; el trabajo lento hazlo fuera de la petición.