Scribara
Sign inBook a demo
DocsAPI
Scribara/Documentation

Documentation.

Everything you need to onboard your practice, integrate the platform, and ship your own workflows. Updated as we ship.

Introduction

Scribara is an ambient AI clinician for specialty practices. This documentation covers everything from the first 15 minutes after you sign your contract to building custom workflows on the platform.

If you're a clinician, start with the Quickstart. If you're an administrator, the SSO setup is the right first stop. If you're a developer, jump to the API reference.

Quickstart — 15 minutes

The fastest path from contract to your first signed Scribara note.

  1. Install the iOS / iPadOS app from the App Store.
  2. Sign in with the magic link from your welcome email.
  3. Pick your specialty pack and primary EHR.
  4. Connect your EHR via the in-app OAuth flow.
  5. Tap Start visit. Walk into the room. Talk to the patient like you always do.
  6. At the end of the visit, review the draft. Sign. Done.

The encounter loop

Scribara models every patient visit as a deterministic state machine — six discrete states, each owned by an agent, each evaluated independently. The loop is the contract: any agent can be upgraded without breaking the others.

# encounter state machine
states:
  - TRIAGE     # pre-visit context loaded
  - LISTEN     # ambient capture streaming
  - ASSEMBLE   # SOAP under construction
  - CODE       # ICD / CPT suggested
  - CLOSE      # auth + referral + follow-up
  - VERIFY     # independent check before signoff

invariants:
  - every transition emits an audit event
  - every artifact is reversible until signed
  - every agent output carries a confidence score

Confidence & abstention

Every Scribara output ships with a confidence score between 0 and 1. Outputs below the workflow's threshold are abstained rather than guessed — they appear in the staff queue with a "needs human" tag instead of going to the chart. Thresholds are configurable per workflow under Settings → Reliability.

Workflow DSL

The Scribara DSL is a small declarative language for composing workflows. A workflow is a trigger plus a sequence of agent calls and conditional branches.

workflow "AF anticoag reconciliation":
  on encounter.signed where diagnosis ∋ "I48"
  steps:
    - read.chart(latest_creatinine, latest_inr)
    - if creatinine_clearance < 30:
        escalate.to(pharm_team)
    - draft.note("anticoag plan", style=provider.voice)
    - queue.signoff(window="30m")

EHR connectors

Connectors are bidirectional by default. The OAuth scopes you grant determine what Scribara can read and write. We never write without an explicit signed action; reads are scoped to encounters that you have active.

See the full integrations list.

SSO / SCIM

Scribara supports SAML 2.0 and OIDC via WorkOS. SCIM provisioning is available on Practice and Enterprise. Configure under Admin → Identity.