Webhooks

Inscreva um endpoint HTTPS em eventos do workspace (por exemplo, quando um agent run termina). As entregas são duráveis — repetidas em caso de falha e registradas — então você não faz polling.

Registrar um webhook

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

body: url (obrigatório, seu receiver HTTPS), events (quais eventos enviar), e uma 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"]}'

Gerenciar e depurar

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

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

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

listar, atualizar (rotacionar URL, mudar events, enabled), excluir.

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

envia uma entrega de teste.

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

entregas recentes + seus status, para depuração.

As entregas são persistidas e repetidas (sobrevivem a um restart), então uma queda temporária do seu lado não descarta um evento. Verifique a assinatura em cada entrega e responda 2xx rapidamente; faça trabalho lento fora da requisição.