Webhooks

Send review state back to the systems that need it.

Webhooks let support tools, internal queues, and product workflows react when Kivo completes a review run or routes an output for human attention.

Event types

Subscribe to the state transitions your workflow actually needs.

review_run.completed

A run has finished extraction, verification, and brief compilation where available.

review_run.failed

A run failed closed and should be inspected or retried.

review_brief.created

A source-linked brief is ready for downstream review queues.

gate_verdict.changed

A verdict changed after policy or reviewer action.

{
  "type": "review_brief.created",
  "review_run_id": "run_123",
  "safe_use_status": "needs_review",
  "unsupported_claim_count": 3,
  "request_id": "req_abc"
}

Route to humans

Send `needs_review` or `needs_repair` runs into the right operations queue.

Retry safely

Use event IDs and request IDs to make downstream processing idempotent.