Error codes
Errors you might encounter when making requests to the Upheal API.
Where errors appear
- Application API: Get session data — property
error - Processing API: Get processing session information — property
results.errors
Summary
| Code | Description | What to do |
|---|---|---|
low-content-transcript | Not enough usable content to generate quality notes. | Record longer/better audio; capture all speakers; reduce noise. |
file-conversion-failed | Recording format is unsupported or file is corrupted. | Re-encode to MP4 (H.264/AAC) and re-upload |
low-content-transcript
Description
The recording doesn’t contain enough usable content to safely generate a progress note. This prevents empty or hallucinated notes.
Common causes
- Very short recording with fewer than ~140 words.
- Very poor audio quality leading to transcription failures.
- Misconfigured microphone capturing only one speaker (often just the therapist).
What to do
- Record longer sessions.
- Improve audio quality (microphone placement, quieter environment, correct input device).
- Ensure all speakers are captured at adequate volume.
file-conversion-failed
Description
The uploaded recording is in an unsupported format or is corrupted and cannot be processed further.
Common causes
- Unsupported/rare container or codec.
- Corrupted file or incomplete upload.
What to do
- Re-encode to a common format (for example, MP4 with H.264 video and AAC audio) and re-upload.