Changelog & Upgrades
Updates to the Nabla Core API — including new features, fields, or endpoints — are released under a new dated version to ensure stability and predictability. This means your integration won’t be affected by these changes unless you explicitly opt into the newer version (see Targeting a specific version).
That said, some updates — like internal AI models improvements, bug fixes, or strictly non-breaking changes that don’t affect the schema or observable behavior — may be rolled out across all versions.
Below is a list of all available Core API versions, along with their associated changes.
2025-04-03​
- Enforce a limit of 700 on the length of the custom instructions per section for note generation endpoints
- Add new User API endpoints to allow users to configure and persist their note generation preferences:
GET /note-settings— Retrieve the user’s preferred locale and template. Default values:note_locale = ENGLISH_US,note_template = GENERIC_MULTIPLE_SECTIONS.PATCH /note-settings— Update the user’s preferred locale and template.GET /note-settings/note-sections-customization/:note_template— Retrieve the default per-section customization options for a specific template.PATCH /note-settings/note-sections-customization/:note_template— Update the default per-section customization options for a specific template.
- Change in User API
/generate-noteand/generate-note-asyncendpoints:- The following fields have been removed from the request body:
note_localenote_templatenote_sections_customization
- These endpoints will now automatically apply the settings stored in the user’s note settings and per-section customization.
- The following fields have been removed from the request body:
- Change in User API
/edit-note-with-instructionsendpoint:- The optional field
note_sections_customizationhas been removed. - The endpoint will now automatically apply the settings stored in the user’s per-section customization, for the locale and note template provided as endpoint parameters.
- The optional field
2025-02-25​
- Bilingual support has been added to transcription endpoints and Websocket.
- In request bodies and WS config frame,
speech_localeproperty has been removed and replaced by newspeech_localesproperty, an array that can contain one or two distinct speech locales.
- In request bodies and WS config frame,
2025-01-07​
- Add a new synchronous dictation from file upload endpoint.
- Add a new asynchronous dictation from file URL, with the ability to either:
- poll the result through a polling endpoint;
- or receive it via a webhook event.
- Note: If you already have a webhook integration set up, make sure you go to the Developer Console and extend its set of enabled event types to include dictation related ones.
- Require endpoints host to specify a region, i.e. either
us.api.nabla.comoreu.api.nabla.com, the genericapi.nabla.comis not supported anymore.
2024-12-23​
- Add new audio chunk acknowledgement protocol, this change applies to all prior versions too.
- Require endpoints paths to start with either "/v1/core/server" or "/v1/core/user", paths like "copilot-api/server", "copilot/server", "copilot-api/user" or "copilot/user" are not supported anymore.
2024-11-08​
- Fixed case for server-to-client frames in Transcribe Websocket. It is now
SCREAMING_SNAKE_CASEfor all the frames, e.g.transcript_itembecomesTRANSCRIPT_ITEM.
2024-10-01​
- New
2024-10-01major API version. Check the Migration guide for an exhaustive list of the changes. - Add support for OAuth Client authentication flow for server-to-server integrations.
- Add support for Webhooks with events sent upon completion of asynchronous tasks like asynchronous note generation.
- Add a new transcription websocket with a simpler frames schema, and support for 35 languages.
- Add a new note generation endpoint with per-section customization capabilities.
- Add a new asynchronous note generation endpoint with the ability to poll the result through a polling endpoint.
- Add a new transcription from file upload endpoint with a simpler body schema.
- Add a new transcription from file upload endpoint with the ability to poll the result through a polling endpoint.
- Change endpoints paths to start with either
/v1/core/serveror/v1/core/user. - Change endpoints host to support for direct URL to a specific geographical region, e.g.
us.api.nabla.com/*instead of justapi.nabla.com/*. - Remove or renamed endpoints (still supported on older versions for backward compatibility):
/digest,/digest_async,/listen,/listen-ws,/listen_async,/generate_normalized_data,/generate_patient_instructions,/dot_phrases&/dot_phrases/{id}.
2024-04-22​
- Add a new endpoint
/generate_patient_instructionsto generate a patient-friendly summary from an encounter. - Add a new endpoint
/generate_normalized_datato generate normalized data from a note, available on both the Server API and the User API. - Add a new WebSocket endpoint
/dictatefor transcribing medical dictation. - Add a new endpoint
/users/find_by_external_id/:external_idto fetch a user with a unique external ID from another system. - Add new endpoints to manage Dot Phrases for a user.
- When set on a user, suggest matching Dot Phrases alongside the generated note in the 'digest' endpoint.
- Add four new templates:
GENERAL_MEDICINE_WCC,SOAP_WCC,GENERAL_MEDICINE_EMERGENCY,SOAP_EMERGENCY. - Add a
titleproperty in the note generated by server digest, server digest async, user digest and user digest async endpoints. The title is a short description of the note content. - Add a
patient_contextproperty indigestanddigest_asyncrequests body. - Add a
PATCH /users/:idendpoint. - Add
external_id,metadataandcreated_aton the User object, the external ID and metadata are editable through the patch endpoint. - Remove
upcoming_appointments_detailsfrom the output of the/generate_patient_instructionsendpoint. Upcoming appointments details are now included inside instructions starting for this version. - Remove
note_generation_moderequest property from digest and digest async endpoints. - Remove
upcoming_appointments_detailsfrom the output of the/generate_patient_instructionsendpoint. Upcoming appointments details are now included insideinstructionsstarting for this version.
2024-02-27​
- Add new endpoints: activate-user & deactivate user.
- Add new endpoints to fetch a single user or all users using filters and pagination.
- Add
split_by_problemto digest & listen-from-file endpoints. - Add optional
client_request_idparameter to/digestand/digest_asyncendpoints. - Deprecate
[es-ES, es-MX]as note generation languages in Core API for digest and listen endpoints. - Remove
note.section.content: string[]field, usage to be replaced bytext: stringwhich is equivalent but formatted. - Remove note generation feature from Listen Websocket API (recommend using the dedicated endpoint).
2023-06-26​
First version of the API.