Guides

Where the API Reference tells you what each endpoint does, these guides explain the workflows those endpoints add up to — the parts that are easy to get wrong because they span several calls.

Patient Registration

How a patient creates an account, what that produces, and how membership of an organization is requested and approved. Covers the split between a login identity and a clinical record, and why one person can be a patient at several organizations.

Messaging

Messaging is addressed to a care team, not to an individual practitioner. That single decision shapes the whole API — how conversations are identified, who can read a thread, and what happens when a clinician goes on leave.

Consent Management

GDPR-compliant consent capture and tracking: what is recorded, how consent is represented as a FHIR resource, and how it is withdrawn.

Multi-Tenant Architecture

Every request is scoped to one organization, carried in the access token. This explains what that means in practice — why searches never return another tenant's rows, why a 404 can mean "not yours", and how a user who works at several organizations switches between them.