Nabla Core User API
Browse all Nabla APIs★ Only Publicly Available OpenAPI DocumentHealthcareClinical Databearer24 EndpointsREST
For Agents
Run client-side ambient transcription, clinical note generation, dot-phrase management, and custom-dictionary editing for individual clinicians on Nabla.
Use for: Transcribe the audio I just recorded for the visit, Add a new dot phrase for my common cardiology assessment template, Update the custom dictionary with a drug name the transcriber keeps mishearing, Refresh my Nabla session token before it expires
Not supported: Does not handle billing claims, prescription writing, or scheduling — use for clinician-side ambient transcription, dot phrases, custom dictionaries, and patient-instruction generation only.
Jentic publishes the only available OpenAPI specification for Nabla Core User API, keeping it validated and agent-ready. Nabla is an AI clinical assistant that produces structured notes, normalized clinical data, and patient instructions from ambient encounter audio. The Core User API is the client-side variant: it powers clinician-facing applications with operations for transcription, digest generation, normalization, patient instructions, dot phrases, custom dictionary expressions, and JWT refresh and logout. It uses an HTTP bearer token minted per clinician.
Install Jentic One Beta
Connect the Core User API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Core User API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Core User API.
Stream or upload encounter audio for ambient transcription via /listen
Generate a structured clinical digest, note, or normalized clinical data for an encounter
Create, update, and delete clinician dot phrases used as text shortcuts in notes
Manage a clinician's custom dictionary expressions for transcription accuracy
Refresh or revoke the clinician's JWT via /jwt/refresh and /jwt/logout
Generate patient-facing visit instructions for handoff
Submit usage reports tied to the clinician's session
Use Cases
Patterns agents use Core User API for, with concrete tasks.
★ Clinician-Side Ambient Documentation
Power a clinician's mobile or web Nabla experience by recording encounter audio, transcribing it, and turning it into a structured note inside the same authenticated session. POST /listen handles audio capture, /digest produces the structured clinical digest, and /generate-note generates the note draft. Replaces dictation or scribe queues so a clinician finishes documentation before they leave the room.
Upload the recording for visit ID 9821 to POST /listen and call POST /digest to retrieve the structured digest for the clinician to review.
Personal Dot-Phrase Library
Clinicians compose notes faster with personal dot phrases, expanded shortcuts that drop in commonly used assessment or plan text. POST /dot-phrases creates entries, GET /dot-phrases lists them, and PATCH /dot-phrases/{id} updates them. The Nabla client UI then surfaces these inside the note editor so the clinician keeps their personal shortcuts across devices.
Create a dot phrase '.aspasse' with the clinician's standard asthma assessment paragraph via POST /dot-phrases.
Custom Dictionary Tuning
Clinicians fix recurring transcription errors by adding their own custom dictionary expressions for drug names, local jargon, and patient names that the base transcription model mishears. POST /custom-dictionary-expressions, PATCH, and DELETE control the entries per clinician. Improves note quality without retraining a model and gives the clinician direct control of their own dictionary.
Add 'tirzepatide' as a custom dictionary expression for the clinician via POST /custom-dictionary-expressions to fix its repeated misrecognition.
After-Visit Patient Instructions
Generate a plain-language after-visit summary for the patient straight from the clinician's device. The patient-instructions operations turn the encounter into medication, follow-up, and red-flag-symptom guidance the patient can read at home. Combined with the EHR portal, this satisfies after-visit-summary requirements without extra clinician typing.
After /digest completes, call the patient-instructions endpoint and email the resulting summary to the patient.
AI Agent Inside the Clinician's Workflow
Embed a Jentic-powered AI agent in the clinician's app that can run 'transcribe this visit', 'add a dot phrase', or 'fix my dictionary' on demand without raw API calls. Through Jentic the per-user JWT stays in the encrypted vault and the agent picks the right operation across 24 endpoints via intent search. Saves clinicians from learning a separate keyboard shortcut surface for each operation.
Search Jentic for 'add a Nabla dot phrase', execute POST /dot-phrases with the clinician's text, and confirm the new entry in the chat.
Key Endpoints
24 endpoints — jentic publishes the only available openapi specification for nabla core user api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/listen
Submit encounter audio for ambient transcription
POST
/digest
Generate a structured clinical digest of an encounter
POST
/generate_normalized_data
Produce normalized clinical data such as ICD codes
POST
/dot-phrases
Create a clinician dot phrase
GET
/dot-phrases
List a clinician's dot phrases
POST
/custom-dictionary-expressions
Add a custom dictionary expression for the clinician
POST
/jwt/refresh
Refresh the clinician's JWT
POST
/jwt/logout
Revoke the current session
POST
/listen
Submit encounter audio for ambient transcription
POST
/digest
Generate a structured clinical digest of an encounter
POST
/generate_normalized_data
Produce normalized clinical data such as ICD codes
POST
/dot-phrases
Create a clinician dot phrase
GET
/dot-phrases
List a clinician's dot phrases
POST
/custom-dictionary-expressions
Add a custom dictionary expression for the clinician
POST
/jwt/refresh
Refresh the clinician's JWT
POST
/jwt/logout
Revoke the current session
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Per-clinician JWTs are stored encrypted in the Jentic vault and injected at execution time. Agents call the Nabla User API through Jentic's execution layer, so bearer tokens never enter the agent's context or chat history.
Intent-based discovery
Agents search by intent (e.g., 'add a Nabla dot phrase' or 'fix transcription dictionary') and Jentic returns the matching operation across 24 endpoints with its parameter schema.
Time to first call
Direct Nabla User API integration: 3-5 days for JWT refresh handling, audio upload, and dot-phrase wiring. Through Jentic: under 2 hours for the first end-to-end transcription and dot-phrase change.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Core User API through Jentic.
Why is there no official OpenAPI spec for Nabla Core User API?
Nabla does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Nabla Core User API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Nabla Core User API use?
The User API uses HTTP bearer authentication with per-clinician JWTs. Tokens are minted by the Server API's /jwt/authenticate/{user_id} endpoint and refreshed via POST /jwt/refresh on the User API. Through Jentic the JWT lives in the encrypted vault and is injected at execution time, so the raw token never enters agent context.
Can I manage a clinician's dot phrases through the API?
Yes. POST /dot-phrases creates a phrase, GET /dot-phrases lists them, GET /dot-phrases/{id} returns one, PATCH /dot-phrases/{id} updates it, and DELETE /dot-phrases/{id} removes it. The Nabla client UI surfaces these as in-line shortcuts inside the note editor.
How do I improve transcription accuracy for unusual drug or term names?
Add per-clinician dictionary entries via POST /custom-dictionary-expressions. PATCH lets you correct an entry and DELETE removes it. The clinician's transcription pipeline then prefers these expressions when it encounters near-matches in audio.
What rate limits apply to the Nabla Core User API?
Rate limits are not declared in the OpenAPI spec. Treat the API as moderately rate-limited per clinician session, implement exponential backoff on HTTP 429, and contact Nabla for committed throughput if you plan to run extensive batch backfills against /listen and /digest.
How do I run a Nabla User API operation from an AI agent through Jentic?
Install the Jentic SDK with pip install jentic. Use SearchRequest with a query like 'transcribe a clinical encounter' to find POST /listen, LoadRequest for its schema, and ExecutionRequest to call it. Get an agent API key at https://app.jentic.com/sign-up.
GET STARTED