Webhooks

为一个 HTTPS 端点订阅工作区事件（例如某个 agent 运行完成时）。投递是持久的——失败会重试并记录在案——因此你无需轮询。

注册一个 webhook

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

请求体：url（必填，你的 HTTPS 接收端）、events（要发送哪些事件）以及 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"]}'

管理与调试

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

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

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

列出、更新（轮换 URL、更改事件、enabled）、删除。

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

发送一次测试投递。

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

近期的投递记录及其状态，用于调试。

投递会被持久化并重试（能挺过重启），因此你一端的短暂中断不会丢失事件。请校验每次投递的签名并快速返回 2xx；耗时的工作放到请求之外处理。