Per-section note customization options

In addition to specifying a template that the generated note will conform to, you can customize each section's content — its style, level of detail, or specific guidelines. All customization options are optional: specify only the ones you care about.

Available options

• Style — Whether you prefer bullet-points or paragraph-like formatting. In some cases, for instance if the content of a section is very brief, requesting BULLET_POINTS will still yield a paragraph because bullet points wouldn't make sense.
• Custom instruction — Free-form guidelines applied to a single section. Keep these clear and concise for best results.
• Level of detail — Whether you prefer the default content density or a more detailed one. Use DETAILED to ask for richer output.
• Split by problem — Structures the section content into subsections, one per distinct clinical problem or topic addressed during the consultation. The subsections live inside the same single string field, so this flag does not change the section's API schema.

Discovering which options apply to a section

Not every customization option is available on every section of every template (and availability can also vary by locale). To find out which options a given section supports for a given template, call:

GET /v1/core/user/note-settings/templates/{template_key}

Each section in the response has a supported_customization_options field listing the dimensions you may set for it (STYLE, CUSTOM_INSTRUCTION, LEVEL_OF_DETAIL, SPLIT_BY_PROBLEM). Only send customizations for options listed there — sending an unsupported option returns an error.

The corresponding Server API endpoint is GET /v1/core/server/generate-note/templates/{template_key}?locale={note_locale}.

Example

Below is a TypeScript snippet demonstrating how to customize sections within the GENERIC_MULTIPLE_SECTIONS_AP_MERGED template on a Server API POST /v1/core/server/generate-note request (on the User API the template and per-section customizations live on /note-settings instead — see the User API note-settings guide):

const generateNoteRequestBody = {
  ...otherFields, // transcript, etc.
  note_locale: "ENGLISH_US",
  note_template_key: "GENERIC_MULTIPLE_SECTIONS_AP_MERGED",
  note_sections_customization: [
    // 'History Of Present Illness' is detailed and split by problem.
    {
      section_key: "HISTORY_OF_PRESENT_ILLNESS",
      level_of_detail: "DETAILED",
      split_by_problem: true,
    },
    // 'Vitals' and 'Allergies' are formatted in bullet points, with custom instructions.
    {
      section_key: "VITALS",
      custom_instruction:
        "Include discussion about the patient's diet and nutritional concerns",
      style: "BULLET_POINTS",
    },
    {
      section_key: "ALLERGIES",
      style: "BULLET_POINTS",
    },
  ],
};

When constructing this list:

• only specify sections that belong to the chosen template — see Templates and sections;
• only specify customization options that the section supports, as returned by the endpoint above;
• each section may appear at most once in the list.