Webhooks

ワークスペースのイベントを受け取る HTTPS エンドポイントを登録します（例：agent run の完了時）。配信は耐久性を持ち——失敗時には再試行され記録されます——そのためポーリングは不要です。

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 のローテーション、events の変更、enabled）、削除。

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

テスト配信を送信します。

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

直近の配信とそのステータス（デバッグ用）。

配信は永続化され再試行されます（再起動後も残ります）ので、あなた側の一時的な障害でイベントが失われることはありません。各配信の署名を検証し、素早く 2xx で応答してください；時間のかかる処理はリクエスト処理の外で行ってください。