Skip to main content
These endpoints cover the ambient session lifecycle: create a session, set and update context, attach metadata, stream audio over WebSocket, and end the session when the recording is finished.

​
Usage scenarios

  • Create a new ambient session for your patient encounter during in-person visits or virtual visits
  • Set and update session context with the patient information, provider details, and diagnosis codes
  • Stream audio over WebSocket to the Suki backend
  • End the session when the recording is finished

​
Endpoints

Create Ambient Session

Initialize a new ambient session for patient encounter documentation

Seed Ambient Session Context

Provide clinical context and patient information for ambient session

Update Ambient Session Context

Update existing session context with new clinical information

Ambient Session Metadata

Add metadata to ambient session (deprecated; use context endpoint instead)

Audio Streaming

WebSocket endpoint for real-time audio streaming during ambient sessions

End Ambient Session

Complete ambient session and trigger clinical note generation

Last modified on May 22, 2026