Webhooks

Receive real-time notifications about validation events via webhooks.

Event Types

run.started

A validation run has started

run.completed

A validation run has completed

run.failed

A validation run has failed

agent.completed

An individual agent has completed

issue.detected

A new issue has been detected

Example Payload

{
  "event": "run.completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "run_id": "run_abc123",
    "status": "passed",
    "duration_ms": 45000,
    "agents_run": 12,
    "issues_found": 0,
    "coverage_score": 92
  }
}

Webhook Security

All webhook payloads are signed with HMAC-SHA256. Verify the X-Zof-Signature header to ensure authenticity.