> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Templates

> Configure the documentation structure for scribe sessions

<Note>
  Building a new integration? Use [Smart Templates](/scribe-api/smart-templates) instead — they give you full control over section shapes while keeping clinical quality via curated [Telepatia Prompts](/scribe-api/telepatia-nodes). Session Templates remain supported for existing integrations.
</Note>

Session templates (also called scribe session configurations) define the structure of the medical documentation produced during a consultation — for example, "Cardiology Consultation" or "General Medicine". Each template determines which sections appear in the final medical record.

## Listing templates

Fetch the available templates for your API key before starting a consultation. This lets you present a selector to the clinician or automatically assign the right template based on specialty.

```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/scribe-session-configurations \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Response:**

```json theme={null}
{
  "items": [
    { "id": "ssc_a1b2c3d4e5f6g7h8", "name": "Cardiology Consultation" },
    { "id": "ssc_i9j0k1l2m3n4o5p6", "name": "General Medicine" }
  ],
  "total": 2,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}
```

## Using a template

Pass the template `id` as `scribeSessionConfigurationId` when setting consultation context:

```json theme={null}
{
  "consultationInternalId": "CONSULT-12345",
  "name": "John Doe",
  "scribeSessionConfigurationId": "ssc_a1b2c3d4e5f6g7h8"
}
```

If `scribeSessionConfigurationId` is omitted, the clinician can select a template manually inside the scribe interface.