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

# Re-Ambient & Session Recovery

> Continue an existing note with re-ambient and recover abandoned Ambient sessions with the Web SDK

## Re-Ambient recovery

Each ambient session creates a new note, even if the patient and encounter identifiers are the same. To continue working on an existing note:

<Steps>
  <Step title="Open Existing Note">
    Open the existing note in the SDK UI.
  </Step>

  <Step title="Initiate Re-Ambient">
    Start re-ambient from the note interface.
  </Step>

  <Step title="Intelligent Merge">
    The SDK intelligently merges the new session content with existing note content, allowing seamless continuation.
  </Step>
</Steps>

## Session recovery

If the app crashes or a session is abandoned (not cancelled or submitted), the Web SDK automatically recovers the last ambient session when the app loads again.

### What gets recovered

<Accordion title="Restore Audio Recording" icon="waveform">
  The last recorded audio is restored and made available for processing.
</Accordion>

<Accordion title="Reattach Session Metadata" icon="database">
  Session metadata (encounter details, timestamps, configuration) is reattached to maintain continuity.
</Accordion>

<Accordion title="User Prompt" icon="circle-question">
  The user is prompted to either generate the note or discard the session. If the user chooses to generate the note, the SDK proceeds with note generation in the background.
</Accordion>

### Best practices

<Note>
  Always submit or cancel the active ambient session when users navigate away from the encounter. This prevents unintended session recoveries.

  **Recommendation:** Show a confirmation dialog before navigation so users can decide whether to continue or discard the session.
</Note>

## Available cookbooks

<div className="hp-io-method-grid tut-hub-card-grid" data-cookbook-related-grid>
  <a className="hp-io-method-card tut-hub-method-card" href="/documentation/cookbooks/resolve-session-conflict">
    <div className="tut-hub-card-media tut-hub-card-media--blue" aria-hidden="true" />

    <div className="hp-io-method-card-body">
      <div className="tut-hub-card-badges">
        <span className="hp-wn-badge hp-wn-badge-new">Ambient</span>
        <span className="hp-wn-badge cookbook-hub-badge-surface cookbook-hub-badge-surface--api">API</span>
      </div>

      <h3 className="hp-io-method-card-title">Clear a Remote Session Conflict</h3>

      <p className="hp-io-method-card-desc cookbook-hub-card-desc">
        End remote session, then retry.
      </p>

      <div className="hp-io-method-card-meta tut-hub-card-foot" aria-label="5 min">
        <div className="tut-hub-card-foot-meta">
          <span className="hp-io-method-card-meta-time">5 min</span>
        </div>
      </div>
    </div>
  </a>
</div>

## Next steps

<Icon icon="file-lines" iconType="solid" /> Offline behavior: [Offline mode](/web-sdk/guides/ambient-offline-mode)

<Icon icon="file-lines" iconType="solid" /> Note submission: [Note management](/web-sdk/guides/note-management)

<Icon icon="file-lines" iconType="solid" /> Return to [Ambient session](/web-sdk/guides/ambient) overview
