The consultation context call sends patient identity and clinical information to Telepatia before a session starts. Telepatia uses this data to pre-populate the patient record in the scribe interface and link the completed session back to your system.
Call this endpoint before generating a login link. If you skip it, the scribe session will start without patient context.
Key fields
| Field | Required | Description |
|---|
consultationInternalId | No | Your internal ID for this consultation. If omitted, Telepatia generates one. Used to retrieve the session later. |
name | Yes | Patient full name |
idCountry | Yes | Country of the ID document (ISO alpha-2, alpha-3, or full name) |
idType | Yes | Type of ID document (see table below) |
idValue | Yes | Document number |
scribeSessionConfigurationId | No | Template ID from /v1/scribe-session-configurations. Pre-selects the documentation structure for the session. |
scribeSessionModality | No | IN_PERSON or REMOTE |
notes | No | Free-text clinical notes visible to the clinician |
pastMedicalHistory | No | Patient’s medical history |
Accepted documents by country
| Country | idCountry | Document | idType | Format |
|---|
| Colombia | CO / COL / COLOMBIA | Cédula de Ciudadanía | CC | 8–10 digits |
| Colombia | | Tarjeta de Identidad | TI | 10–11 digits |
| Colombia | | Cédula de Extranjería | CE | 6–7 digits |
| Colombia | | Registro Civil | RC | 1–11 digits |
| Brazil | BR / BRA / BRAZIL | Registro Geral | RG | 7–9 alphanumeric |
| Brazil | | CPF | CPF | XXX.XXX.XXX-XX |
| Any | — | Passport | PASSPORT | 6–9 alphanumeric |
| Any | — | Other | OTHER_DOC | Any non-empty string |
The idType must be valid for the given idCountry. For example, passing CC with idCountry: BR returns a 400 error.
Example request
curl -X POST https://synapse.telepatia.ai/v1/set-consultation-context \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"consultationInternalId": "CONSULT-12345",
"name": "John Doe",
"idCountry": "CO",
"idType": "CC",
"idValue": "123456789",
"notes": "Patient reports recurring headache",
"pastMedicalHistory": "Hypertension diagnosed 2020",
"scribeSessionModality": "IN_PERSON",
"scribeSessionConfigurationId": "ssc_a1b2c3d4e5f6g7h8"
}'
{
"success": true,
"consultationInternalId": "CONSULT-12345"
}
Save the consultationInternalId — you’ll need it to generate the login link and retrieve the session results.
