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로 응답하세요. 느린 작업은 요청에서 벗어나 처리하세요.