Webhooks

訂閱一個 HTTPS 端點以接收工作區事件（例如 agent run 完成時）。傳遞具備持久性——失敗時會重試並記錄——因此你不需要輪詢。

註冊 webhook

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

body：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、變更 events、enabled）、刪除。

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

發送一次測試傳遞。

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

近期的傳遞紀錄與其狀態，供除錯使用。

傳遞會被持久化並重試（即使重啟也不會遺失），因此你端短暫的中斷不會丟失事件。請驗證每次傳遞的簽章並盡快回應 2xx；耗時工作請離開請求處理流程執行。