Skip to content

Build with SynthBoard

Give every one of your users their own experts.

One call gives each person who uses your app their own SynthBoard: the right AI expert on each question, their papers and dates kept, the work followed through.

Two doors#

Each of your users gets their own SynthBoard

Create an office per user with your own user id. Ask, read the record and the events. Billed to your organization.

Quickstart › · Reference ›

Your agent consults its person's SynthBoard

With their consent, within the allowance they set, on their credits — over MCP and OAuth.

MCP ›

What your app sends, and what comes back#

What your app sends, and what comes back

POST /v1/offices/eb692f9c-a278-4445-9548-acd8af9a1dde/ask
Idempotency-Key: panes-demo-1

{
  "text": "My landlord wants to raise the rent 9% mid-lease. Can he? (expert)"
}

{
  "schema_version": "0.8.0",
  "status": "ok",
  "turn_id": "1742fbd1-f65b-4f02-a92e-50b48dce45bd",
  "lang": "en",
  "link": "https://www.synthboard.ai/developers/sandbox",
  "speaker": "expert",
  "handoff": {
    "expert": {
      "id": "22222222-2222-4222-8222-222222222222",
      "name": "The Career Coach",
      "role": "Career Coach",
      "face": null,
      "hue": "#5b5bd6",
      "runnable": true
    },
    "brought": {
      "their_words": true,
      "fact_count": 0,
      "reads": 0
    },
    "swap_options": []
  },
  "expert_turns": [
    {
      "turn_id": "1742fbd1-f65b-4f02-a92e-50b48dce45bd",
      "session_id": "d50b092b-5f42-473f-873e-63aba1188f75",
      "matter_id": "",
      "lane_synth_id": "22222222-2222-4222-8222-222222222222",
      "expert": {
        "id": "22222222-2222-4222-8222-222222222222",
        "name": "The Career Coach",
        "role": "Career Coach",
        "face": null,
        "hue": "#5b5bd6",
        "runnable": true
      },
      "via": "route",
      "state": "delivered",
      "weight": "full",
      "body_md": "**The strongest route: lecturing at a teaching college.** A sandbox expert answer.",
      "doc": {
        "segments": [
          {
            "t": "md",
            "md": "**The strongest route: lecturing at a teaching college.** A sandbox expert answer."
          }
        ],
        "frame": {
          "call": null,
          "ask": null,
          "meta": null
        },
        "issues": [],
        "budget": {
          "components": 0,
          "interactive": 0,
          "calcs": 0,
          "by_kind": {},
          "longest_prose_words": 12,
          "limits": null
        },
        "complete": true
      },
      "call": {
        "line": "Apply to the teaching college first.",
        "would_change_it": "If another opening appears before December.",
        "when_we_know": "2026-11-15"
      },
      "split_signal": null,
      "used_from_you": [],
      "sources": [],
      "computed": [],
      "second_opinion": null,
      "checked": null,
      "follow_offer": null,
      "cost": {
        "used": null
      },
      "timing": {
        "strip_ms": null,
        "first_content_ms": null,
        "first_word_ms": null,
        "done_ms": null
      },
      "made_with": {
        "model": "sandbox",
        "lab": "sandbox",
        "recipe": "sandbox",
        "effort": "none"
      },
      "answer": {
        "shape": null,
        "reply_md": "**The strongest route: lecturing at a teaching college.** A sandbox expert answer.\n\n**My call: Apply to the teaching college first.**\nWhat would change it: If another opening appears before December.\nWhen we'll know: Sunday 15 November 2026",
        "reply_text": "The strongest route: lecturing at a teaching college. A sandbox expert answer.\n\nMy call: Apply to the teaching college first.\nWhat would change it: If another opening appears before December.\nWhen we'll know: Sunday 15 November 2026",
        "blocks": [
          {
            "type": "markdown",
            "md": "**The strongest route: lecturing at a teaching college.** A sandbox expert answer."
          }
        ],
        "drafts": [],
        "call": {
          "line": "Apply to the teaching college first.",
          "would_change_it": "If another opening appears before December.",
          "when_we_know": "2026-11-15"
        },
        "question": null
      }
    }
  ],
  "matter": null,
  "record": {},
  "speed": {
    "class": "answer",
    "expected_by": "2026-10-25T09:00:56.000Z",
    "basis": {
      "source": "static",
      "stat": "p50",
      "seconds": 56,
      "n": null,
      "measured_at": null
    }
  },
  "follow_offer": null,
  "saved_facts": [],
  "moves": [],
  "cards": [],
  "follow_ups": [],
  "files": [],
  "cost": {
    "used": 0,
    "balance_after": 0
  },
  "steps": [],
  "provenance": {
    "ai_generated": true,
    "models": [
      {
        "model": "sandbox",
        "lab": "sandbox"
      }
    ]
  },
  "opinion": {
    "who": [
      {
        "practice": "22222222-2222-4222-8222-222222222222",
        "lead": {
          "id": "22222222-2222-4222-8222-222222222222",
          "name": "The Career Coach",
          "role": "Career Coach",
          "face": null,
          "hue": "#5b5bd6",
          "runnable": true
        }
      }
    ],
    "call": {
      "line": "Apply to the teaching college first.",
      "would_change_it": "If another opening appears before December.",
      "when_we_know": "2026-11-15"
    },
    "grade": null,
    "scope_limits": [],
    "evidence": [],
    "computed": [],
    "unchecked": [],
    "method": {
      "practice_id": "22222222-2222-4222-8222-222222222222",
      "method_version": null,
      "contract_version": "0.8.0",
      "model": "sandbox",
      "lab": "sandbox",
      "recipe": "sandbox"
    }
  },
  "legacy_status": "done",
  "reply": "**The strongest route: lecturing at a teaching college.** A sandbox expert answer.",
  "agent_cards": [],
  "disclosure": "Experts and answers here are AI.",
  "notice": "Answers here come from SynthBoard's AI experts. What you send here is shared with SynthBoard to answer you."
}
See how it renders ↓
The Career Coachvia SynthBoard

The strongest route: lecturing at a teaching college. A sandbox expert answer.

The experts are AI — named roles, not people.

This is the sandbox's own answer, exactly as a test key gets it. Most answers are just an excellent answer. Structure comes back only when the question needs it — your code never has to fill a verdict.

The experts are AI — named roles, not people. How this works

Every guide#

  • The sandboxTest keys, sample answers by the words you send, test logs — free, never a model.
  • OfficesOne per user of your app: isolation, language, pause, export, erase.
  • AskingThe ask, who answers, waiting for a turn, and bigger work that waits for a yes.
  • AnswersWhat always comes back, and the fields that appear only when the matter calls for them.
  • MattersWhat a matter is, and reading an office's matters, record and files.
  • Events and webhooksThe events, signatures, retries, and reading events by cursor.
  • BillingAbout what each call costs, the monthly cap, the balance and debt.
  • Showing answersThe notice your users must see, three ready forms, do and don't.
  • What your users' data doesIsolation, export and erase, and what we never do with it.
  • Regulated topicsLegal, medical and money questions, and what your app must not build.
  • ErrorsEvery error code and its HTTP status.
  • IdempotencyOne turn per Idempotency-Key: retries never charge twice.
  • Rate limitsThe read, write and ask buckets, per organization and environment.