API reference

Authentication

All requests require Authorization: Bearer <api_key>. Generate API keys from Settings → API Keys in your dashboard. Keys are prefixed dv_live_.

Submit an AI message for review

POST /v1/gate/outbound

Submits an AI-generated message to the governance gate. The policy engine scans instantly — BLOCKED submissions never reach a human; QUEUED submissions land in your approval queue.

export DV_API_URL="https://api.datavibe.cc"
export DV_KEY="dv_live_your_api_key_here"

curl -sS -X POST "$DV_API_URL/v1/gate/outbound" \
  -H "Authorization: Bearer $DV_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "[email protected]",
    "subject": "Following up on your trial",
    "body_html": "<p>Hi Alex, wanted to check in on your Q2 targets.</p>",
    "source_model": "gpt-4o",
    "campaign_id": "q2-outreach"
  }'

Example response (policy passed, awaiting review):

{
  "action_id": "gate_01hw3k...",
  "status": "QUEUED",
  "policy_passed": true,
  "policy_violations": [],
  "review_url": "https://app.datavibe.cc/queue/gate_01hw3k...",
  "message": "Submission queued for human review."
}

Example response (policy blocked — no review created):

{
  "action_id": "gate_01hw9z...",
  "status": "BLOCKED",
  "policy_passed": false,
  "policy_violations": [
    {
      "rule": "pricing_hallucination",
      "severity": "BLOCK",
      "detail": "Message contains unverified pricing claim: '50% cheaper than competitors'"
    }
  ],
  "review_url": null,
  "message": "Submission blocked by policy engine. No human review required."
}

Poll submission status

GET /v1/gate/outbound/:action_id

Returns current status. Poll until status is one of APPROVED, REJECTED, BLOCKED, or SENT.

curl -sS "$DV_API_URL/v1/gate/outbound/gate_01hw3k..." \
  -H "Authorization: Bearer $DV_KEY"

{
  "action_id": "gate_01hw3k...",
  "status": "APPROVED",
  "policy_passed": true,
  "policy_violations": [],
  "reviewed_by": "[email protected]",
  "reviewed_at": "2026-05-19T14:23:11Z"
}

Status lifecycle

• QUEUED — passed policy scan, awaiting human approval
• BLOCKED — hard-blocked by policy engine, never queued
• APPROVED — human approved, dispatch scheduled
• REJECTED — human rejected, message discarded
• SENT — dispatched to recipient
• FAILED — dispatch attempted but delivery failed

Health

• GET /v1/health — liveness
• GET /v1/health/db — database readiness

Other route groups

• /v1/gate/… — submission CRUD, status polling, execution
• /v1/governance/config — workspace policy configuration
• /v1/governance/export — streaming NDJSON audit export
• /v1/governance/webhook — SIEM webhook registration (NDJSON / CEF)

See the OpenAPI document for full request and response models.

OpenAPI schema

Download /docs/openapi.json