Nabla Core User API

Name: Core User API
Brand: Nabla Core User API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentHealthcareClinical Databearer24 EndpointsREST

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Core User API

Explore with Jentic

View OpenAPI Document

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.

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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your per-clinician Nabla JWT is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'add a Nabla dot phrase' or 'fix the transcription dictionary', and Jentic returns the matching Nabla operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

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 with Jentic One, the self-hosted execution layer.

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 through Jentic One, the self-hosted execution layer.

Can I limit what my agent is allowed to do with the Nabla Core User API?

Yes. Because you run Jentic One yourself, your own rules decide which Nabla operations and credentials the agent may use. Nabla addresses these clinician resources through request bodies rather than a resource ID in the URL path, so you allow only the operations the agent needs, such as POST /dot-phrases to add a dot phrase or POST /custom-dictionary-expressions to fix the transcription dictionary. You can keep session-ending operations like POST /jwt/logout out of the allowed set, and the per-clinician JWT stays under your control rather than in the agent's prompt.

Nabla Core User API

Connect the Core User API to your agent

Capabilities

Start building with Core User API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs