> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.thymia.ai/apollo/llms.txt.
> For full documentation content, see https://docs.thymia.ai/apollo/llms-full.txt.

# Error Reference

When an Apollo model run completes with status `COMPLETE_ERROR`, the
response includes two fields:

| Field         | Description                                                                      |
| ------------- | -------------------------------------------------------------------------------- |
| `errorCode`   | Machine-readable error code. Use this to handle errors programmatically.         |
| `errorReason` | Human-readable description. Intended for debugging, not for display to patients. |

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "COMPLETE_ERROR",
  "errorCode": "ERR_RECORDING_TOO_SHORT",
  "errorReason": "One or more recordings supplied contained less
    than the minimum required amount of speech.",
  "userLabel": "patient-5678"
}
```

<Note>
  Error details must not be surfaced directly to patients. Present
  a neutral message and prompt the patient to repeat the recording
  where applicable.
</Note>

## Error codes

### ERR\_RECORDING\_INVALID\_FORMAT

One or more recordings were not in a supported file format.

**Supported formats:** FLAC, MP3, MP4, Ogg, WebM, WAV

**Affects:** Either or both recordings.

**Recommended action:** Verify the file format of both recordings
and convert if necessary before submitting a new model run.

***

### ERR\_RECORDING\_TOO\_SHORT

One or more recordings contained less than the minimum required
amount of speech.

**Minimum speech duration:** 15 seconds per recording

**Affects:** Either or both recordings.

**Recommended action:** Ask the patient to speak continuously for
at least 15 seconds per recording and submit a new model run.

***

### ERR\_RECORDING\_TOO\_LONG

One or more recordings exceeded the maximum allowed length.

**Maximum recording length:** 3 minutes per recording

**Affects:** Either or both recordings.

**Recommended action:** Trim the affected recording and submit a
new model run.

***

### ERR\_TRANSCRIPTION\_FAILED

No speech was detected in one or more recordings.

**Affects:** Either or both recordings.

**Recommended action:** Check audio quality of both recordings.
Ask the patient to record in a quiet environment with a working
microphone.

***

### ERR\_INTERNAL

An internal error occurred during model processing.

**Recommended action:** Retry the model run. If the error persists,
contact [support@thymia.ai](mailto:support@thymia.ai) with the
model run ID. Document the error for audit purposes.

***

## Warnings

```json
{
  "status": "COMPLETE_OK",
  "warnings": ["Audio quality may affect result accuracy."],
  "results": { ... }
}
```

<Warning>
  In a clinical context, results returned alongside warnings should
  be flagged to the reviewing clinician before acting on the results.
</Warning>

## HTTP errors

| Status code | Meaning              | Common cause                                                                        |
| ----------- | -------------------- | ----------------------------------------------------------------------------------- |
| `401`       | Unauthorized         | Missing or invalid API key                                                          |
| `404`       | Not found            | Model run ID does not exist, data has been deleted, or Apollo access is not enabled |
| `422`       | Unprocessable entity | Request body is malformed or missing required fields                                |

<Note>
  A `404` response may indicate the 12-hour data deletion window has
  passed. Ensure results and reports are stored before deletion occurs.
</Note>

## Next steps

* [Integration Guide](/apollo/integration-guide)
* [Interpreting Results](/apollo/interpreting-results)
* [Reports](/apollo/reports)
* [API Reference](/api-reference)

<div>
  ***
</div>

<div>
  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/bc677a592c05a522bf7c895b7e9f00da344a3487d5e6baf5e35f4b013bf0e0e5/docs/assets/certs/crown-commerical-logo.png" alt="Crown Commercial Service" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/0fd8cd1c5e2bf5fe9c88a9671b5d62d76ee00fff93b057d3f28295f6e74a8e54/docs/assets/certs/nhs-digital-toolkit-logo.png" alt="NHS Digital" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/3408b37c11afb0482b6108012fdea2edc6843ffa1a6a485d9440f2c28067165c/docs/assets/certs/iso-27001-logo.png" alt="ISO 27001" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/f82c2989ef0c7907f8acc1bf38c1debfb8061a0bad0fd4aff7a724794739e5b0/docs/assets/certs/iso-13485-logo.png" alt="ISO 13485" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/44816901d032fd0dc4b99030c62e6841d10b1796fde6dd1615bf23eb84f9114b/docs/assets/certs/HIPPA-logo.png" alt="HIPAA" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/1c6800dfced2f3bd97bd907302e2ae105c99ed91fd381e0cd64eef7886394779/docs/assets/certs/gdpr-logo.png" alt="GDPR" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/2276326b82aee8a143219440498266a25a1425c423a6854489e706af50d38118/docs/assets/certs/cyber-essentials-logo.png" alt="Cyber Essentials Certified" />
</div>