Python SDK

pip install datavibe

from datavibe import DataVibeClient

client = DataVibeClient(api_key="dv_live_your_key")

result = await client.intercept_async(
    recipient="prospect@example.com",
    subject="Following up",
    body_text="Hi Jordan, checking in.",
    body_html="<p>Hi Jordan, checking in.</p>",
    source_model="gpt-4o",
    idempotency_key="campaign-42-send-1001",
)

if result.status in {"BLOCKED", "FAILED", "REJECTED"}:
    raise RuntimeError(f"Do not send: {result.status}")

if result.status in {"QUEUED", "DISPATCHING"}:
    print("Hold for review:", result.action_id, result.review_url)
else:
    print("Released:", result.action_id)

preview = client.check("AI-generated text", content_type="email")

# Validate a key. No policy scan, no quota consumed.
datavibe whoami

# Send a test payload through the stateless preview (POST /v1/check).
# Exits non-zero on a blocked verdict, so it's safe as a CI smoke check.
datavibe gate test --content "..." --content-type email --source-model gpt-4o

# Submit a real outbound payload (POST /v1/gate/outbound). Can queue,
# block, or auto-send depending on your workspace's approval mode.
datavibe gate intercept \
  --recipient prospect@example.com \
  --subject "Following up" \
  --body-html "<p>Hi Jordan, checking in.</p>" \
  --source-model gpt-4o