---
title: "Generate Consult Note"
method: POST
path: "/api/v2/ml-scribe/open-api/sessions/{session_id}/consult-note"
tags: ["Heidi API"]
---

# Generate Consult Note

`POST /api/v2/ml-scribe/open-api/sessions/{session_id}/consult-note`

Generate a session consult note by either template, ai command or ai command text
or generate a session dictation.
dictation - AI cleaned up transcript

## Path parameters

- `session_id` string, required

## Request body

- OpenAPIGenerateConsultNoteRequest — template_id, third_party_template are mutually exclusive
  - `generation_method` 'TEMPLATE' | 'THIRD_PARTY_TEMPLATE', required
  - `template_id` string, nullable
  - `third_party_template` string, nullable
  - `addition` string
  - `voice_style` 'BRIEF' | 'GOLDILOCKS' | 'DETAILED' | 'MY_VOICE' | 'SUPER_DETAILED', required — was called writing style
  - `brain` 'LEFT' | 'RIGHT' — Brain enum for different AI model configurations. Each brain represents a different AI model configuration with specific characteristics: - LEFT: Fast and simple model - RIGHT: Creative and artistic model
  - `custom_style` CustomStyle
    - `level_of_detail` 'LOW' | 'MEDIUM' | 'HIGH', required
    - `bullet_points_preference` boolean — Whether to use bullet points in the note
    - `patient_quotes_preference` boolean — Whether to include patient quotes in the note
    - `abbreviations_preference` boolean — Whether to use abbreviations in the note
  - `content_type` 'MARKDOWN'
  - `dictation_cleanup_mode` 'SMART' | 'WORD_FOR_WORD'
  - `ignore_backup` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/heidihealth/apis/heidi-api-documentation.md) · [All operations](https://skmtc.net/heidihealth/apis/heidi-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heidihealth/heidi-api-documentation/versions/39b46a9d8637/schema)