| 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 <jeremy@intentsolutions.io> |
| 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 |
