Integration Guide

import requests, time

API_KEY = "your_relayna_api_key"
BASE    = "https://relayna.app/api"

# Create checkpoint
res = requests.post(f"{BASE}/checkpoints",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "title": "Approve invoice #INV-2847",
        "instructions": "Verify vendor details before approving payment.",
        "callback_url": "https://yourapp.com/webhooks/relayna",
        "external_ref": "inv_2847",
        "metadata": {"amount": 12400, "currency": "USD"},
    }
)
chk = res.json()
print("Review link:", chk["review_url"])

# (Optional) Poll until decided
while True:
    s = requests.get(f"{BASE}/checkpoints/{chk['id']}/status",
        headers={"Authorization": f"Bearer {API_KEY}"}
    ).json()
    if s["status"] != "pending":
        print("Decision:", s["status"], "-", s.get("decision_comment"))
        break
    time.sleep(5)

const API_KEY = process.env.RELAYNA_API_KEY;
const BASE    = "https://relayna.app/api";

// 1. Upload a file
const form = new FormData();
form.append("file", fs.createReadStream("./report.pdf"));

const asset = await fetch(`${BASE}/assets/upload`, {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}` },
  body: form,
}).then(r => r.json());

// 2. Create checkpoint with the asset
const chk = await fetch(`${BASE}/checkpoints`, {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "Review Q4 report before publishing",
    instructions: "Check figures on page 3 match the spreadsheet.",
    callback_url: "https://yourapp.com/webhooks/relayna",
    items: [{ item_type: "asset", label: "Q4 Report", asset_id: asset.asset.id }],
  }),
}).then(r => r.json());

console.log("Share this link:", chk.review_url);

api_key = System.fetch_env!("RELAYNA_API_KEY")

{:ok, %{body: body}} =
  Req.post("https://relayna.app/api/checkpoints",
    auth: {:bearer, api_key},
    json: %{
      title: "Approve database migration",
      instructions: "Review the migration script before it runs on production.",
      callback_url: "https://yourapp.com/webhooks/relayna",
      external_ref: "migration_20251119",
      items: [%{item_type: "text", label: "SQL", content: "ALTER TABLE orders ADD COLUMN ..."}]
    }
  )

IO.puts("Review link: #{body["review_url"]}")