> ## 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.

# Form Filling Session Management APIs

> Create and manage Form filling sessions: context, audio streaming, and end session

The Form filling Session Management APIs enable partners to run the Form filling session lifecycle for a patient <Tooltip tip="One patient visit or appointment with a healthcare provider. In Suki, an encounter can group one or more ambient sessions so related recordings and notes stay tied to the same clinical visit." cta="View in Glossary" href="/Glossary/e">encounter</Tooltip>. 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

<Columns cols={3}>
  <Card title={<><Badge color="blue" size="sm">POST</Badge> Create Form Filling Session</>} href="/form-filling-api-reference/form-filling-sessions/create" arrow={true} icon="code">
    <Callout type="info">
      Purpose: Create a new Form filling session for a patient encounter
    </Callout>
  </Card>

  <Card title={<><Badge color="blue" size="sm">POST</Badge> Seed Form Filling Session Context</>} href="/form-filling-api-reference/form-filling-sessions/context" arrow={true} icon="code">
    <Callout type="info">
      Purpose: Seed form template metadata and encounter details for the session
    </Callout>
  </Card>

  <Card title={<><Badge color="green" size="sm">PATCH</Badge> Update Form Filling Session Context</>} href="/form-filling-api-reference/form-filling-sessions/update-context" arrow={true} icon="code">
    <Callout type="info">
      Purpose: Update context during an active Form filling session
    </Callout>
  </Card>

  <Card title={<><Badge color="green" size="sm">GET</Badge> Audio Streaming</>} href="/form-filling-api-reference/form-filling-sessions/audio-stream" arrow={true} icon="code">
    <Callout type="info">
      Purpose: Stream visit audio over WebSocket for the Form filling session
    </Callout>
  </Card>

  <Card title={<><Badge color="blue" size="sm">POST</Badge> End Form Filling Session</>} href="/form-filling-api-reference/form-filling-sessions/end" arrow={true} icon="code">
    <Callout type="info">
      Purpose: End the Form filling session when that recording is finished
    </Callout>
  </Card>
</Columns>

## Related guides

<Columns cols={3}>
  <Card title="Form Filling Basic Usage" href="/documentation/how-to/form-filling/form-filling-basic-usage" icon="book" cta="Learn more">
    Learn the Form filling create, stream, end, and retrieve flow
  </Card>

  <Card title="Form Filling Templates" href="/documentation/concepts/form-filling/form-filling-templates" icon="book" cta="Learn more">
    Choose Medical form templates before you seed session context
  </Card>

  <Card title="Form Filling Overview" href="/documentation/concepts/form-filling/form-filling-overview" icon="book" cta="Learn more">
    Learn when Form filling fits your clinical workflow
  </Card>
</Columns>

## Common use cases

<Columns cols={2}>
  <Card title="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.
  </Card>

  <Card title="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.
  </Card>

  <Card title="Adjust form context during the visit">
    Update template or encounter details while the Form filling session is still active.
  </Card>

  <Card title="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.
  </Card>
</Columns>