thymia Documentation

Every Apollo model run that completes with status COMPLETE_OK generates a clinical report available in two formats — a web view and a downloadable PDF.

Apollo reports must be reviewed and interpreted by a qualified healthcare professional. They must not be shared directly with patients without clinical review.

Report URLs

1 {
2   "report": {
3     "viewUrl": "https://reports.thymia.ai/v1/reports/a1b2c3d4?token=...",
4     "pdfUrl": "https://reports.thymia.ai/v1/reports/a1b2c3d4/pdf?token=...",
5     "accessExpiresAt": "2024-03-08T09:01:10Z"
6   }
7 }

Field	Description
`viewUrl`	URL to view the report in a browser
`pdfUrl`	URL to download the report as a PDF
`accessExpiresAt`	ISO 8601 timestamp when both URLs expire

URL expiry

Report URLs expire at the time indicated in accessExpiresAt. To retrieve fresh URLs, poll the model run endpoint again — new URLs will be returned as long as the model run data has not been deleted.

If data deletion is enabled (deleteData: true), report URLs will become inaccessible 12 hours after the model run completes, regardless of accessExpiresAt. Ensure reports are accessed and stored before this window closes.

Accessing the report

Web view

1 <iframe
2   src="https://reports.thymia.ai/v1/reports/a1b2c3d4?token=..."
3   width="100%"
4   height="800px">
5 </iframe>

PDF download

$ curl "https://reports.thymia.ai/v1/reports/a1b2c3d4/pdf?token=..." \
>   -o apollo-report-patient-5678.pdf

Report contents

Section	Description
Patient details	User label, assessment date, and model version
Disorder summary	Probability and severity scores for depression and anxiety
Symptom breakdown	Severity and distribution scores for all core DSM-V symptoms
Clinical interpretation	Guidance on interpreting scores in a clinical context

Storing reports

For clinical governance and audit purposes, download and store the PDF report in your patient records system as soon as it becomes available — particularly if data deletion is enabled.

Reports