Skip to main content
The Form filling Session Management APIs enable partners to run the Form filling session lifecycle for a patient . An encounter is the visit. A Form filling session is one capture instance for that visit. One encounter can include one or more Form filling sessions. For each session, you create a Form filling session, seed or update session context with form template metadata, stream visit audio over the shared Partner WebSocket, then end the session when that recording is finished. Ending a Form filling session closes that capture so Suki can finish form processing. It does not mean the encounter is closed if another Form filling session will follow. These APIs are called from your servers and authenticated with a Suki Token (sdp_suki_token). Critically, stream audio with your Form filling ambient_session_id. Ending the session closes capture so Suki can finish form processing.

​
Available endpoints

Create Form Filling Session

Create a new Form filling session for a patient encounter

Seed Form Filling Session Context

Seed form template metadata and encounter details for the session

Update Form Filling Session Context

Update context during an active Form filling session

Audio Streaming

Stream visit audio over WebSocket for the Form filling session

End Form Filling Session

End the Form filling session when that recording is finished

Form Filling Basic Usage

Learn the Form filling create, stream, end, and retrieve flow

Form Filling Templates

Choose Medical form templates before you seed session context

Form Filling Overview

Learn when Form filling fits your clinical workflow

​
Common use cases

Fill nursing and intake forms from the visit

Capture the encounter conversation so Suki can populate the selected Medical form template without a separate form-entry workflow.

Bind the right Medical form template

Attach template and encounter details to the session so structured output matches the assessment or intake form your workflow expects.

Adjust form context during the visit

Update template or encounter details while the Form filling session is still active.

Finalize the session for structured form output

End the Form filling session when that recording is finished so Suki can generate fields for review, EHR handoff, or webhooks. Start another session on the same encounter when the visit needs more capture.
Last modified on August 7, 2026