Clear a Remote Session Conflict

Problem: Create returns HTTP 409 (session_in_progress) because another modality already has an active session for the same emr_encounter_id. Solution: Read ambient_session_id from the conflict response, End session, wait 1 second, then retry create.

This cookbook assumes you already have your Partner ID, authentication tokens, and the other prerequisites for Ambient APIs.

TypeScript
Python

const headers = {
  "Content-Type": "application/json",
  sdp_suki_token: sdpSukiToken,
  sdp_provider_id: sdpProviderId,
};

async function createOrResolveConflict(emrEncounterId: string) {
  const createRes = await fetch("https://sdp.suki.ai/api/v1/ambient/session/create", {
    method: "POST",
    headers,
    body: JSON.stringify({ emr_encounter_id: emrEncounterId }),
  });

  if (createRes.ok) {
    return createRes.json();
  }

  const err = await createRes.json().catch(() => ({}));
  const message = String(err?.message || "");
  const isConflict =
    createRes.status === 409 || message.includes("session_in_progress");

  if (!isConflict) {
    throw new Error(`Create ambient session failed: ${createRes.status}`);
  }

  const blockingSessionId = err.ambient_session_id;
  if (!blockingSessionId) {
    throw new Error(
      "Conflict returned without ambient_session_id. End the active session from the owning modality, then retry."
    );
  }

  const endRes = await fetch(
    `https://sdp.suki.ai/api/v1/ambient/session/${blockingSessionId}/end`,
    {
      method: "POST",
      headers: {
        sdp_suki_token: sdpSukiToken,
        sdp_provider_id: sdpProviderId,
      },
    }
  );
  if (!endRes.ok) {
    throw new Error(`End ambient session failed: ${endRes.status}`);
  }

  await new Promise((r) => setTimeout(r, 1000));

  const retry = await fetch("https://sdp.suki.ai/api/v1/ambient/session/create", {
    method: "POST",
    headers,
    body: JSON.stringify({ emr_encounter_id: emrEncounterId }),
  });
  if (!retry.ok) {
    throw new Error(`Retry create failed: ${retry.status}`);
  }
  return retry.json();
}

import time
import requests

headers = {
    "Content-Type": "application/json",
    "sdp_suki_token": sdp_suki_token,
    "sdp_provider_id": sdp_provider_id,
}

def create_or_resolve_conflict(emr_encounter_id: str):
    create = requests.post(
        "https://sdp.suki.ai/api/v1/ambient/session/create",
        headers=headers,
        json={"emr_encounter_id": emr_encounter_id},
    )
    if create.ok:
        return create.json()

    try:
        err = create.json()
    except ValueError:
        err = {}

    message = str(err.get("message") or "")
    is_conflict = create.status_code == 409 or "session_in_progress" in message
    if not is_conflict:
        create.raise_for_status()

    blocking = err.get("ambient_session_id")
    if not blocking:
        raise RuntimeError(
            "Conflict returned without ambient_session_id. "
            "End the active session from the owning modality, then retry."
        )

    end = requests.post(
        f"https://sdp.suki.ai/api/v1/ambient/session/{blocking}/end",
        headers={
            "sdp_suki_token": sdp_suki_token,
            "sdp_provider_id": sdp_provider_id,
        },
    )
    end.raise_for_status()
    time.sleep(1)

    retry = requests.post(
        "https://sdp.suki.ai/api/v1/ambient/session/create",
        headers=headers,
        json={"emr_encounter_id": emr_encounter_id},
    )
    retry.raise_for_status()
    return retry.json()

Common mistakes

Confirm the blocking id before you end. Wait 1 second before retry.
If the body omits ambient_session_id, end from the owning modality, then retry.

Other cookbooks

AmbientAPI

Share one note with emr_encounter_id.

5 min

AmbientAPI

Poll Session Status Before Fetching Content

Poll until status is completed.

5 min

​Common mistakes

​Other cookbooks

​Share One Note Across Products

​Poll Session Status Before Fetching Content

Common mistakes

Other cookbooks

Share One Note Across Products

Poll Session Status Before Fetching Content