Core User API

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

★ Only Publicly Available SpecHealthcareClinical Databearer24 EndpointsREST

For Agents

Run client-side ambient transcription, clinical note generation, dot-phrase management, and custom-dictionary editing for individual clinicians on Nabla.

Quickstart

Get started with Core User API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"transcribe a clinical encounter from the clinician's device"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Core User API 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

GET STARTED

Start building with Core User API API

Explore with Jentic

View OpenAPI Spec

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 Core User API, keeping it validated and agent-ready.

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.

Use Cases

Patterns agents use Core User API 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 though 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.

Complementary

DrChrono API

EHR destination for Nabla-generated notes and patient instructions

Pair DrChrono with Nabla User when DrChrono is the EHR of record and the clinician's app handles the documentation handoff.

Complementary

athenahealth API

Enterprise EHR destination for normalized clinical data and notes

Pair athenahealth with Nabla when the EHR-side workflow needs Nabla's structured digest and ICD normalization written back.

Alternative

Deepgram Speech-to-Text API

General-purpose transcription rather than clinical-specific dot phrases and dictionary tuning

Choose Deepgram when you only need raw transcription and will produce notes and codes yourself, instead of Nabla's clinically-tuned features.

Complementary

Nabla Core Server API

Server-side companion for OAuth, user provisioning, and JWT minting

Use the Server API for backend OAuth, user lifecycle, and JWT issuance; use this User API on the clinician's device for in-session operations.

FAQs

Specific to using Core User API 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.