Generate a note
POST/digest
Digests a list of transcript items and produces a structured clinical note.
Requestā
- application/json
Body
required
Array [
]
Array [
]
Specifies which items you want us to send you back. In other words, which feature(s) you want to use, for now only note generation is available.
Possible values: [note
]
Language of the given transcript and the desired note ('fr' and 'en' are deprecated, and correspond to 'fr-FR' and 'en-US' respectively. Generating a note in 'es-ES' and 'es-MX' is not supported and will be soon removed).
Possible values: [fr
, en
, en-US
, en-GB
, fr-FR
, es-ES
, es-MX
]
en-US
transcript_items
object[]required
The transcribed text.
Also, Iām allergic to peanuts.
Who said the text in this transcript item.
Possible values: [doctor
, patient
, unspecified
]
doctor
Choose a desired style for note sections:
⢠paragraphs
: Prioritizes generating paragraphs;
⢠bullet_points
: Prioritizes structuring content using bullet points.
⢠auto
: Automatically picks the most natural formatting option.
Default is auto
.
Possible values: [auto
, paragraphs
, bullet_points
]
paragraphs
Flag to structure the content of the note sections according to distinct clinical problems or topics addressed during the consultation.
When this flag is enabled, the text within some sections of the clinical note is organized into subsections, each corresponding to a specific problem or topic. This format aims to enhance the clarity and organization of the clinical note, making it easier to read and understand the different issues discussed during the consultation.
Important: Currently, the application of this flag is limited to the HISTORY_OF_PRESENT_ILLNESS
and SOAP_SUBJECTIVE
sections and is only effective when the language is set to English (US or GB).
false
The desired template of the generated note.
Some templates are only available in specific languages. Check Note template for details.
Possible values: [GENERAL_MEDICINE
, GENERAL_MEDICINE_AP_MERGED
, CARDIOLOGY
, PSYCHIATRY
, DIET
, PSYCHOLOGY
, SOAP
, GENERAL_MEDICINE_WCC
, SOAP_WCC
, GENERAL_MEDICINE_EMERGENCY
, SOAP_EMERGENCY
]
GENERAL_MEDICINE
note object
sections
object[]required
A key identifying a section of a note. The set of possible keys depend on the template that is used. Check Note template for possible values.
Possible values: [ALLERGIES
, APPOINTMENTS
, ASSESSMENT
, ASSESSMENT_AND_PLAN
, CARDIOVASCULAR_RISKS
, CHIEF_COMPLAINT
, CURRENT_MEDICATIONS
, DIET_APPOINTMENTS
, DIET_CHIEF_COMPLAINT
, DIET_HABITS
, DIET_LIFESTYLE
, DIET_MEDICAL_HISTORY
, DIET_OBJECTIVES
, DIET_VITALS
, FAMILY_HISTORY
, HISTORY_OF_PRESENT_ILLNESS
, IMAGING_RESULTS
, IMMUNIZATIONS
, LAB_RESULTS
, MENTAL_HEALTH_EXAM
, MENTAL_HEALTH_HISTORY
, PAST_MEDICAL_HISTORY
, PAST_OBSTETRIC_HISTORY
, PAST_SURGICAL_HISTORY
, PHYSICAL_EXAM
, PLAN
, PRESCRIPTION
, PSYCHOLOGY_HISTORY_OF_COMPLAINT
, SOAP_ASSESSMENT
, SOAP_OBJECTIVE
, SOAP_PLAN
, SOAP_SUBJECTIVE
, SOCIAL_HISTORY
, VITALS
, WELL_CHILD_CARE
]
CHIEF_COMPLAINT
The section title.
Chief complaint
Content of the note section (required).
Sleep disorder
Some contextual information that will be used to generate the note (for example name, gender, age, pronouns, medical history) [BETA].
Possible values: <= 700 characters