Skip to main content
POST
/
api
/
v1
/
ambient
/
session
/
create
Creates an ambient session.
curl --request POST \
  --url https://sdp.suki-stage.com/api/v1/ambient/session/create \
  --header 'Content-Type: application/json' \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --data '
{
  "ambient_session_id": "123dfg-456dfg-789dfg-012dfg",
  "encounter_id": "123dfg-456dfg-789dfg-012dfg"
}
'
{
  "ambient_session_id": "123dfg-456dfg-789dfg-012dfg"
}

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.

UpdatedThe multilingual parameter is deprecated.Multilingual support is now enabled by default for all ambient sessions. You no longer need to pass this parameter. The API automatically supports conversations in multiple languages and generates the in English.
Use this endpoint to create an . Suki will generate an ambient_session_id and return it in the response. Use this ambient_session_id to identify the in subsequent API calls. We recommend that an ambient session be at least 1 minute long.
In case of a short session, the note generation will be skipped.

​
Code examples

import requests

url = "https://sdp.suki.ai/api/v1/ambient/session/create"
headers = {
    "sdp_suki_token": "<sdp_suki_token>",
    "Content-Type": "application/json"
}

payload = {
    "ambient_session_id": "123dfg-456dfg-789dfg-012dfg",  # Optional, UUID format
    "encounter_id": "123dfg-456dfg-789dfg-012dfg"  # Optional, UUID format
}

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

if response.status_code == 201:
    data = response.json()
    ambient_session_id = data["ambient_session_id"]
    print(f"Session created successfully. Session ID: {ambient_session_id}")
else:
    print(f"Failed to create session: {response.status_code}")
    print(response.json())

Headers

​
sdp_suki_token
string
required

sdp_suki_token

Body

application/json

CreateSessionRequest

Request body for the /session/create endpoint

​
ambient_session_id
string

Optional - UUID format

Example:

"123dfg-456dfg-789dfg-012dfg"

​
encounter_id
string

Optional - UUID format

Example:

"123dfg-456dfg-789dfg-012dfg"

​
multilingual
boolean
deprecated

Deprecated. Multilingual support is now true by default. To disable it, contact the Suki support team.

Example:

true

Response

Success Response

Response body for the /session/create endpoint

​
ambient_session_id
string
Example:

"123dfg-456dfg-789dfg-012dfg"

Last modified on March 26, 2026