Skip to main content
Alongside the audio (or transcript) you can pass metadata that controls how the note is generated. This applies to every note-producing endpoint: /api/v1/notes and /api/v1/sessions/:id/notes.

​
Parameters

FieldTypeDescription
languagestringOutput language. sv, en, fi, nb, da, de, tr, ar. Default sv.
templateSectionsstring (JSON)A template structure that defines the sections the note must contain. When provided, the note is generated to match it.
templatestringId of a template registered with Recnote (alternative to inline templateSections).
sideNotestringFree-text context appended to the transcript before generation (e.g. clinician notes).
primaryProfessionstringProfession context that tunes terminology (e.g. physician, dentist, physiotherapist).
customTemplatestringA free-form custom template body, if you don’t use structured sections.

​
Inline template structure

templateSections is a JSON array describing the sections. Each section has a name and AI rules controlling whether it is auto-filled. Pass it as a string: 
curl -X POST https://api.recnote.ai/api/v1/notes \
  -H "Authorization: Bearer $RECNOTE_API_KEY" \
  -F "file=@consultation.wav" \
  -F "language=sv" \
  -F 'templateSections=[
        {"sectionName":"Anamnes","aiRules":{"autoFill":true}},
        {"sectionName":"Status","aiRules":{"autoFill":true}},
        {"sectionName":"Bedömning","aiRules":{"autoFill":true}},
        {"sectionName":"Åtgärd","aiRules":{"autoFill":true}}
      ]'
The returned note.sections array mirrors your structure, each entry carrying the generated content for that section, plus a combined field with the full note rendered as text.

​
When no template is given

If you omit template and templateSections, the note is generated with the default SOAP structure (reason for visit, subjective, objective, assessment, plan, diagnoses).

​
JSON body alternative

When sending a transcript (no audio), pass the same fields as JSON: 
{
  "transcript": "...",
  "language": "sv",
  "templateSections": "[{\"sectionName\":\"Anamnes\",\"aiRules\":{\"autoFill\":true}}]",
  "primaryProfession": "physician"
}