Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
🚀 New Form Filling SDK is out! Refer to the Release notes for details.
Pass emr_encounter_id on create so ambient sessions share one clinical note across modalities
emr_encounter_id on Create ambient session. Store ambient_session_id and composition_id. In the Web SDK, use the same value as encounter.identifier.
curl --request POST \
--url https://sdp.suki.ai/api/v1/ambient/session/create \
--header 'Content-Type: application/json' \
--header 'sdp_suki_token: <sdp_suki_token>' \
--header 'sdp_provider_id: <sdp_provider_id>' \
--data '{
"emr_encounter_id": "6ec3920f-b0b1-499d-a4e9-889bf788e5ab"
}'
import requests
response = requests.post(
"https://sdp.suki.ai/api/v1/ambient/session/create",
headers={
"Content-Type": "application/json",
"sdp_suki_token": sdp_suki_token,
"sdp_provider_id": sdp_provider_id,
},
json={
"emr_encounter_id": "6ec3920f-b0b1-499d-a4e9-889bf788e5ab",
},
)
response.raise_for_status()
data = response.json()
ambient_session_id = data["ambient_session_id"]
composition_id = data["composition_id"]
# If you omitted encounter_id on create, composition_id is also the Session Group ID.
const response = await fetch("https://sdp.suki.ai/api/v1/ambient/session/create", {
method: "POST",
headers: {
"Content-Type": "application/json",
sdp_suki_token: sdpSukiToken,
sdp_provider_id: sdpProviderId,
},
body: JSON.stringify({
emr_encounter_id: "6ec3920f-b0b1-499d-a4e9-889bf788e5ab",
}),
});
if (!response.ok) {
throw new Error(`Create ambient session failed: ${response.status}`);
}
const data = await response.json();
const ambientSessionId = data.ambient_session_id;
const compositionId = data.composition_id;
// If you omitted encounter_id on create, composition_id is also the Session Group ID.
{
"ambient_session_id": "<ambient_session_id>",
"composition_id": "<composition_id>"
}
emr_encounter_id and the note is not interoperable.emr_encounter_id must be a UUID. Wait at least 1 second between creates for the same encounter.Was this page helpful?
Suggestions