What’s new
New Features
New features
Patient Summary API v1.0.0Patient Summary API: New APIs that let partners upload FHIR data into Suki’s Clinical Knowledge Graph (CKG), trigger asynchronous Patient Summary generation, poll job status, and retrieve full and pre-visit summaries for encounter preparation and clinical review workflows.Key endpoints- GET /api/v1/fhir-push/upload-url: Request an upload URL for a FHIR bundle.
- PUT /api/v1/fhir-push/upload: Upload a FHIR bundle to the CKG ingestion endpoint.
- GET /api/v1/fhir-push/status/: Check the ingestion status for a previously uploaded bundle.
- POST /api/v1/patient-summary/generate/encounter: Enqueue Patient Summary generation for a single encounter.
- POST /api/v1/patient-summary/generate/provider-schedule: Enqueue summaries for a provider schedule or batch run.
- GET /api/v1/patient-summary/: Retrieve a generated Patient Summary by ID.
- GET /api/v1/patient-summary//pre_visit: Retrieve a pre-visit summary used for encounter preparation.
- GET /api/v1/patient-summary/encounter//practitioner/: Retrieve a practitioner-facing encounter summary filtered for a specific practitioner.
- GET /api/v1/patient-summary/encounter//practitioner//pre_visit: Retrieve a practitioner-facing pre-visit summary for an encounter.
- GET /api/v1/patient-summary/encounter//practitioner//status: Poll generation status for an encounter-specific Patient Summary job.
- GET /api/v1/patient-summary//status: Poll the generation or processing status for a Patient Summary by ID.
Common use cases
- Prepare for patient encounters: Display pre-visit summaries so clinicians can quickly review the patient’s history, active problems, medications, and recent results before the appointment.
- Review completed encounters: Retrieve summaries after a visit to verify documentation, identify follow-up actions, and support billing or quality workflows.
- Prepare an entire schedule: Generate pre-visit summaries for all scheduled appointments so care teams can review patients and prioritize care before the clinic day begins.
What’s enhanced
Enhancements
Enhancements
Web SDK v3.3.0Patient Summary in the Web SDK: From Web SDK v3.3.0, the Headed Web SDK can show a pre-visit Patient Summary on the patient profile. Clinicians see a short snippet, then expand it for the full summary.To enable this feature in the headed Web SDK:- Upgrade
@suki-sdk/jsor@suki-sdk/reactto v3.3.0 or later. - Ask Suki Technical Support to enable Patient Summary for your organization.
- Keep ingesting FHIR into CKG with the Patient Summary CKG Data Ingestion APIs.
- Pass the FHIR encounter id as
encounter.identifierand the FHIR practitioner id asencounter.practitionerFhirIdwhen you initialize, and pass the sameencounteragain when you mount.
setEncounter loads the summary. It does not generate again. To generate Patient Summary for a different practitioner, initialize the SDK again with the new practitioner id.Why it matters: Clinicians get pre-visit context on the patient profile before the appointment, without leaving the headed Web SDK. If you already embed the Web SDK, you can ship that experience without building the summary screens or wiring generate and retrieve calls yourself.Learn more in the Patient Summary in Web SDK guide, the Encounter type, and the Web SDK changelog.