Webhooks

Subscribe an HTTPS endpoint to workspace events (for example, when an agent run completes). Deliveries are durable — retried on failure and recorded — so you don't poll.

Register a webhook

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

body: url (required, your HTTPS receiver), events (which events to send), and a 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"]}'

Manage & debug

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

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

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

list, update (rotate URL, change events, enabled), delete.

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

send a test delivery.

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

recent deliveries + their status, for debugging.

Deliveries are persisted and retried (they survive a restart), so a transient outage on your side won't drop an event. Verify the signature on each delivery and respond 2xx quickly; do slow work off the request.