> ## Documentation Index
> Fetch the complete documentation index at: https://developer.suki.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambient Session Management APIs

> Create and manage Ambient sessions, stream audio, attach metadata, and end sessions

The Ambient Session Management APIs enable partners to run the ambient session lifecycle for a patient encounter. You create a session, seed or update encounter context, optionally attach metadata, stream visit audio over WebSocket, then end the session when capture is finished.

These APIs are called from your servers and authenticated with a Suki Token (`sdp_suki_token`). Critically, ending the session is what closes capture cleanly so Suki can finish processing. Streaming alone does not replace the End Ambient Session call.

## Available endpoints

<Columns cols={3}>
  <Card title="Create Ambient Session" href="/api-reference/ambient-sessions/create" arrow={true} icon="code">
    Create a new ambient session for a patient encounter
  </Card>

  <Card title="Seed Ambient Session Context" href="/api-reference/ambient-sessions/context" arrow={true} icon="code">
    Seed patient, provider, and encounter context for the session
  </Card>

  <Card title="Update Ambient Session Context" href="/api-reference/ambient-sessions/update-context" arrow={true} icon="code">
    Update context during an active ambient session
  </Card>

  <Card title="Ambient Session Metadata" href="/api-reference/ambient-sessions/metadata" arrow={true} icon="code">
    Attach or update metadata for an ambient session
  </Card>

  <Card title="Audio Streaming" href="/api-reference/ambient-sessions/audio-stream" arrow={true} icon="code">
    Stream visit audio over WebSocket to the Suki backend
  </Card>

  <Card title="End Ambient Session" href="/api-reference/ambient-sessions/end" arrow={true} icon="code">
    End the ambient session when recording is finished
  </Card>
</Columns>

## Related guides

<Columns cols={3}>
  <Card title="Ambient Audio Streaming" href="/documentation/how-to/audio-streaming/ambient-audio-streaming" icon="book" cta="Learn more">
    Learn how to stream ambient audio for a live session
  </Card>

  <Card title="Streaming Architecture" href="/documentation/how-to/audio-streaming/streaming-architecture" icon="book" cta="Learn more">
    Learn how the Ambient streaming architecture works
  </Card>

  <Card title="Ambient Documentation" href="/documentation/concepts/ambient-clinical-notes/ambient-documentation" icon="book" cta="Learn more">
    Learn how ambient sessions turn conversation into clinical notes
  </Card>
</Columns>

## Common use cases

<Columns cols={2}>
  <Card title="Generate clinical notes inside your existing chart">
    Capture the visit conversation in your product so Suki can draft the clinical note while clinicians stay in your EHR workflow.
  </Card>

  <Card title="Shape note output with visit context">
    Provide diagnoses, note sections, specialty, and EMR encounter details so generated notes match the visit your system already knows.
  </Card>

  <Card title="Continue one note across phone and desktop">
    Share an EMR encounter ID so clinicians can start capture on one modality and finish review on another without losing the note.
  </Card>

  <Card title="Finalize capture for note generation">
    End the ambient session cleanly when the visit finishes so Suki can process the recording for review, retrieval, or webhooks.
  </Card>
</Columns>