Get note template detail
GET/generate-note/templates/:template_key
Get metadata and sections for a single note template.
Request
Responses
- 200
Template detail.
Operation spec
{
"method": "get",
"path": "/generate-note/templates/{template_key}",
"operationId": "get-generate-note-template",
"parameters": [
{
"name": "template_key",
"in": "path",
"required": true,
"description": "Human-readable identifier of the note template. Use [List note templates](/2026-07-01/server/list-generate-note-templates) to get available keys.",
"schema": {
"type": "string"
}
},
{
"name": "locale",
"in": "query",
"required": true,
"description": "Locale used to localize template titles and descriptions.",
"schema": {
"type": "string",
"description": "Locale of the note.",
"enum": [
"ENGLISH_US",
"ENGLISH_UK",
"FRENCH_FR"
],
"example": "ENGLISH_US",
"title": "note_locale"
}
}
],
"responses": {
"200": {
"description": "Template detail.",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"key",
"title",
"description",
"sections",
"supported_source_note_section_kinds"
],
"properties": {
"key": {
"type": "string",
"description": "Human-readable identifier for this template."
},
"title": {
"type": "string",
"description": "The template title in the requested locale."
},
"description": {
"type": "string",
"description": "The template description in the requested locale."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"title",
"supported_customization_options"
],
"properties": {
"key": {
"type": "string",
"description": "Human-readable identifier for this section within the template."
},
"title": {
"type": "string",
"description": "The section title."
},
"supported_customization_options": {
"type": "array",
"description": "Which per-section customization dimensions are supported for this section. Only options listed here should be sent when updating customization for this section.",
"items": {
"type": "string",
"enum": [
"CUSTOM_INSTRUCTION",
"SPLIT_BY_PROBLEM",
"LEVEL_OF_DETAIL",
"STYLE"
],
"description": "A per-section customization dimension that the section supports. Use this to know which fields you may send when patching the section's customization.",
"title": "note_template_section_customization_option"
}
}
},
"title": "generate_note_template_section"
},
"description": "Sections defined for this template."
},
"supported_source_note_section_kinds": {
"type": "array",
"description": "The set of semantic section kinds this template can accept as `source_note.sections[].kind` inputs to `/generate-note`. An empty list means this template does not support follow-up note generation today.",
"items": {
"type": "string",
"enum": [
"ASSESSMENT_AND_PLAN",
"ASSESSMENT",
"PLAN"
],
"description": "The semantic meaning of a section. This is independent of the template's section layout and identifies what kind of clinical content the section carries (e.g. an Assessment & Plan combined section, or a standalone Assessment or Plan).\nThe kinds listed here are subject to change: new values can be added independently of API versions. Keep your client tolerant to new enum values.",
"title": "semantic_section_kind"
}
}
},
"title": "generate_note_template_detail"
}
}
}
}
}
}