Skip to main content
A Smart Template (medicalRecordConfiguration) defines the medical record your consultation produces: a map of sections, where each section is a node with an output schema and a prompt strategy.
Prefer Smart Templates with Telepatia nodes. This is the recommended path: you control the EMR-shaped output, Telepatia maintains the curated medical prompts behind each node. Session Templates (scribeSessionConfigurationId) remain supported for legacy integrations.

​
Lifecycle

  1. Define the sections (nodes) you need — see Nodes.
  2. Create it via POST /v1/medical-record-configurations. Telepatia hashes the content; identical configurations return the same id with created: false (idempotent).
  3. Reference it on POST /v1/set-consultation-context using one of the two fields below.

​
Three ways to attach a template to a session

ModeField on set-consultation-contextWhen to use
Smart Template inlinemedicalRecordConfigurationShip the full JSON with each session. Telepatia auto-persists and dedups by content hash. Recommended for client-driven flows.
Smart Template by idmedicalRecordConfigurationIdYou already created it via POST /v1/medical-record-configurations and want to reuse the id.
Session TemplatescribeSessionConfigurationIdLegacy curated flows.
Pass exactly one of the three. A future scribeTemplates field will accept either kind of template id — no breaking change is planned for the current variants.

​
Create a Smart Template

curl -X POST https://scribe-api.telepatia.ai/v1/medical-record-configurations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "General Consultation",
    "configuration": {
      "chiefComplaint": {
        "instructionSet": { "telepatiaPromptId": "CHIEF_COMPLAINT" },
        "schema": {
          "type": "object",
          "instructions": "Chief complaint",
          "properties": {
            "chiefComplaint": { "type": "string", "instructions": "Patient words" }
          }
        }
      }
    }
  }'
Response: 
{
  "id": "mrc_a1b2c3d4e5f6g7h8",
  "hash": "sha256:…",
  "createdAt": "2026-06-02T10:00:00Z",
  "created": true
}

​
List Smart Templates

curl https://scribe-api.telepatia.ai/v1/medical-record-configurations \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Get a Smart Template by id

curl https://scribe-api.telepatia.ai/v1/medical-record-configurations/mrc_a1b2c3d4e5f6g7h8 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Next steps