Seeds Session Context

Provide clinical context and patient information for ambient session

Use this endpoint to provide or update the clinical context for an ambient session. Providing detailed context helps Suki generate a more accurate and relevant clinical note.

For example, you can provide:

• Provider details (e.g., specialty and role).
• Patient and visit information.
• A list of LOINC codes for the clinical sections you want to generate.
• Existing diagnoses with their associated medical codes. For more information about the context, refer to the Problem-based charting and Specialty section.

Updated:

The request body for this endpoint now supports the new visit and provider_role fields.

• The request body will now include the new visit field within the payload. The visit field contains information about the visit such as chief complaint, encounter type, reason for visit, and visit type.
• The request body will now include the new provider_role field within the payload. The provider_role field contains information about the provider.

You can use the Codes section to provide additional context for a session, such as medical codes for a diagnosis.

The type field in the Codes section can have one of the following values:

• ICD10 (Recommended)

• IMO

To avoid request failures, you must ensure the data you send adheres to the following validation rules:

• The chief_complaint and reason_for_visit fields must not exceed 255 characters.

• The visit_type, encounter_type, and provider_role fields function as enums and only accept a specific set of predefined string values. You must use one of the allowed values for these fields, as any other string will cause the request to fail.

Code Examples

Python

import requests

ambient_session_id = "123dfg-456dfg-789dfg-012dfg"
url = f"https://sdp.suki.ai/api/v1/ambient/session/{ambient_session_id}/context"

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

payload = {
    "provider": {
        "specialty": "CARDIOLOGY",
        "provider_role": "ATTENDING"
    },
    "patient": {
        "dob": "2000-01-01",
        "sex": "male"
    },
    "visit": {
        "chief_complaint": "Headache",
        "encounter_type": "AMBULATORY",
        "reason_for_visit": "Follow-up for migraines",
        "visit_type": "ESTABLISHED_PATIENT"
    },
    "sections": [
        {"loinc": "10164-2"},
        {"loinc": "48765-2"}
    ],
    "diagnoses": {
        "values": [
            {
                "codes": [
                    {
                        "code": "30422",
                        "description": "Essential hypertension",
                        "type": "ICD10"
                    }
                ],
                "diagnosis_note": "Hypertension"
            }
        ]
    }
}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 200:
    print("Context seeded successfully")
else:
    print(f"Failed to seed context: {response.status_code}")
    print(response.json())

Headers

sdp_suki_token · string · required

Path Parameters

ambient_session_id · string · required

Body

application/json

diagnoses · object

Show child attributes

patient · object

Show child attributes

provider · object

Show child attributes

sections · object[]

Show child attributes

visit · object

Show child attributes