abridge-common-errors

name	abridge-common-errors
description	Diagnose and fix common Abridge clinical AI integration errors. Use when encountering EHR connectivity failures, note generation errors, audio streaming issues, or FHIR validation problems with Abridge. Trigger: "abridge error", "abridge not working", "abridge debug", "fix abridge issue", "abridge troubleshoot".
allowed-tools	Read, Write, Edit, Bash(curl:*), Grep
version	1.0.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","healthcare","ai","abridge","troubleshooting"]
compatible-with	claude-code

Abridge Common Errors

Overview

Comprehensive troubleshooting guide for Abridge clinical documentation integration. Covers authentication failures, EHR connectivity, audio streaming, note generation, and FHIR push errors.

Error Reference

Authentication & Authorization Errors

Code	Error	Root Cause	Fix
401	INVALID_CREDENTIALS	Expired or wrong partner secret	Rotate credentials in Abridge Partner Portal
401	TOKEN_EXPIRED	SMART on FHIR token expired	Refresh token before 60-min expiry
403	ORG_NOT_PROVISIONED	org_id not activated	Contact Abridge sales engineer
403	SPECIALTY_NOT_LICENSED	Specialty not in contract	Check licensed specialties in Partner Portal
403	PROVIDER_NOT_ENROLLED	Provider not onboarded	Complete provider enrollment in Abridge admin

Session & Encounter Errors

Code	Error	Root Cause	Fix
409	SESSION_ALREADY_ACTIVE	Duplicate session for same encounter	Reuse existing session_id
422	INVALID_SPECIALTY	Unsupported specialty code	Use codes from /specialties endpoint
422	PATIENT_NOT_FOUND	Patient ID not in EHR context	Verify FHIR Patient resource exists
408	SESSION_TIMEOUT	Session idle > 30 minutes	Create new session; old ones auto-expire
500	SESSION_CORRUPTED