Run a boardroom
from any HTTP client.

curl

# 1. Start a board
curl https://synthboard.ai/api/v1/sessions \
  -H "Authorization: Bearer sb_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Should we launch a free tier?",
    "session_type": "boardroom",
    "mode": "decision"
  }'
# → { "session_id": "...", "task_id": "...", ... }

# 2. Long-poll until the run finishes
curl "https://synthboard.ai/api/v1/sessions/{id}?wait_ms=60000" \
  -H "Authorization: Bearer sb_live_..."

# 3. Read the memo on the same response
# v4_phase: "done"
# memo: { verdict, confidence_0_100, conditions, dissent }

Python (requests)

import requests

API = "https://synthboard.ai/api/v1"
H = {"Authorization": "Bearer sb_live_..."}

s = requests.post(f"{API}/sessions", headers=H, json={
    "question": "Should we launch a free tier?",
    "session_type": "boardroom",
    "mode": "decision",
}).json()

session = {}
while session.get("v4_phase") != "done":
    session = requests.get(
        f"{API}/sessions/{s['session_id']}",
        headers=H, params={"wait_ms": 60000},
    ).json()

print(session["memo"]["verdict"])

TypeScript (fetch)

const API = "https://synthboard.ai/api/v1";
const headers = {
  Authorization: "Bearer sb_live_...",
  "Content-Type": "application/json",
};

const { session_id } = await fetch(`${API}/sessions`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    question: "Should we launch a free tier?",
    session_type: "boardroom",
    mode: "decision",
  }),
}).then((r) => r.json());

let session;
do {
  session = await fetch(
    `${API}/sessions/${session_id}?wait_ms=60000`,
    { headers },
  ).then((r) => r.json());
} while (session.v4_phase !== "done");

console.log(session.memo.verdict);

The Consult — one expert, turn by turn

# Open a 1-on-1 with a named expert
curl https://synthboard.ai/api/v1/sessions \
  -H "Authorization: Bearer sb_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Tear down my pricing page",
    "session_type": "consult",
    "synth_id": "the-cmo"
  }'

Consult turns are driven through the MCP tool synthboard.consult.message — each call returns the expert's reply and any composed document, billed per turn. See the MCP docs.