Skip to main content
PATCH
/
api
/
v1
/
ambient
/
session
/
{ambient_session_id}
/
context
Updates context for the ambient session.
curl --request PATCH \
  --url https://sdp.suki-stage.com/api/v1/ambient/session/{ambient_session_id}/context \
  --header 'Content-Type: application/json' \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --data @- <<EOF
{
  "diagnoses": {
    "values": [
      {
        "codes": [
          {
            "code": "30422",
            "description": "Essential hypertension",
            "type": "IMO"
          }
        ],
        "diagnosis_note": "Hypertension"
      }
    ]
  },
  "emr": {
    "target_emr": "ATHENA"
  },
  "orders": {
    "medication_orders": {
      "values": [
        {
          "drug_name": "Acetaminophen 500mg Tab",
          "medication_code": {
            "code": "860975",
            "type": "RXCUI"
          },
          "metadata": {
            "origin": "SUKI_AMBIENT",
            "encounter_relation": "CURRENT_ENCOUNTER"
          },
          "status": "ACTIVE",
          "dosage": {
            "quantity": 1,
            "raw_value": "1 tablet",
            "unit": "TAB"
          },
          "duration_in_days": 7,
          "end_date": "2026-01-08T00:00:00Z",
          "format": {
            "raw_value": "Tablet"
          },
          "frequency": {
            "raw_value": "once daily",
            "structured_value": "ONE_A_DAY"
          },
          "instructions": "Take with food",
          "linked_diagnosis_codes": [
            {
              "code": "I10",
              "type": "ICD10"
            }
          ],
          "medication_timing": {
            "raw_value": "morning",
            "structured_value": "IN_THE_MORNING"
          },
          "number_of_refills": 3,
          "quantity_dispensed": "1 box",
          "route": {
            "raw_value": "Oral"
          },
          "start_date": "2026-01-01T00:00:00Z",
          "strength": {
            "raw_value": "500mg"
          }
        }
      ]
    }
  },
  "patient": {
    "dob": "2000-01-01",
    "sex": "male"
  },
  "provider": {
    "provider_role": "ATTENDING",
    "specialty": "CARDIOLOGY"
  },
  "sections": [
    {
      "loinc": "10164-2"
    }
  ],
  "visit": {
    "chief_complaint": "Headache (Patient's primary symptom or problem stated in their own words)",
    "encounter_type": "AMBULATORY",
    "reason_for_visit": "Follow-up for migraines",
    "visit_type": "ESTABLISHED_PATIENT"
  }
}
EOF
{
  "context": {
    "diagnoses": {
      "values": [
        {
          "codes": [
            {
              "code": "30422",
              "description": "Essential hypertension",
              "type": "IMO"
            }
          ],
          "diagnosis_note": "Hypertension"
        }
      ]
    },
    "emr": {
      "target_emr": "ATHENA"
    },
    "orders": {
      "medication_orders": {
        "values": [
          {
            "drug_name": "Acetaminophen 500mg Tab",
            "medication_code": {
              "code": "860975",
              "type": "RXCUI"
            },
            "metadata": {
              "origin": "SUKI_AMBIENT",
              "encounter_relation": "CURRENT_ENCOUNTER"
            },
            "status": "ACTIVE",
            "dosage": {
              "quantity": 1,
              "raw_value": "1 tablet",
              "unit": "TAB"
            },
            "duration_in_days": 7,
            "end_date": "2026-01-08T00:00:00Z",
            "format": {
              "raw_value": "Tablet"
            },
            "frequency": {
              "raw_value": "once daily",
              "structured_value": "ONE_A_DAY"
            },
            "instructions": "Take with food",
            "linked_diagnosis_codes": [
              {
                "code": "I10",
                "type": "ICD10"
              }
            ],
            "medication_timing": {
              "raw_value": "morning",
              "structured_value": "IN_THE_MORNING"
            },
            "number_of_refills": 3,
            "quantity_dispensed": "1 box",
            "route": {
              "raw_value": "Oral"
            },
            "start_date": "2026-01-01T00:00:00Z",
            "strength": {
              "raw_value": "500mg"
            }
          }
        ]
      }
    },
    "patient": {
      "dob": "2000-01-01",
      "sex": "male"
    },
    "provider": {
      "provider_role": "ATTENDING",
      "specialty": "CARDIOLOGY"
    },
    "sections": [
      {
        "loinc": "10164-2"
      }
    ],
    "visit": {
      "chief_complaint": "Headache (Patient's primary symptom or problem stated in their own words)",
      "encounter_type": "AMBULATORY",
      "reason_for_visit": "Follow-up for migraines",
      "visit_type": "ESTABLISHED_PATIENT"
    }
  }
}

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.

Updated:You can now update the ambient session context with new EMR context and medication orders.
Use this endpoint to update the for an . The API applies a field mask so you can send only the parts of the context you want to change. This is a PATCH operation that allows partial updates to the session context.

​
Comparison with POST Context

FeaturePOST (Seed)PATCH (Update)
PurposeSet entire context all at once when availableIncrementally build context as information becomes available
Data ApproachComplete context payloadPartial context updates
TimingBefore EndSession. When you have all context information together.Before EndSession. As information becomes available progressively
BehaviorReplaces entire contextUpdates only specified fields

Headers

​
sdp_suki_token
string
required

sdp_suki_token

Path Parameters

​
ambient_session_id
string
required

ambient_session_id

Body

application/json

UpdateContextRequest

Request body for the /session/{ambient_session_id}/context PATCH endpoint

​
diagnoses
object

Optional - Information about the diagnoses

​
emr
object

Optional - Information about EMR context

​
orders
object

Optional - Information about orders context

​
patient
object

Optional - Information about the patient

​
provider
object

Optional - Information about the provider

​
sections
object[]

Optional - Information about the sections to be generated. If not provided, all supported note-sections will be generated.

​
visit
object

Optional - Information about the visit

Response

Success Response

Response body for the /session/{ambient_session_id}/context PATCH endpoint

​
context
object

Updated context for the session

Last modified on April 20, 2026