Public API

Public workflows for assessments, contact, and careers.

Theen exposes a small public API surface for commercial and assessment workflows. Administrative endpoints stay private and are not part of this contract.

Assessment workflow

Create a scan, monitor it, retrieve the report JSON, and download a PDF when needed.

EndpointMethodPath
Submit assessmentPOST/api/assess/submit
Assessment statusGET/api/assess/status/{runId}
Assessment reportGET/api/assess/report/{runId}
Assessment PDFGET/api/assess/pdf/{runId}

Contact and meeting requests

Use the contact endpoint for general inquiries and appointment-style requests.

EndpointMethodPath
Contact or meeting requestPOST/api/contact

Careers

Submit public applications for open roles through the careers application endpoint.

EndpointMethodPath
Career applicationPOST/api/careers/apply

Request and response notes

All public endpoints accept JSON requests. Responses are JSON except for the assessment PDF download, which returns binary PDF content.

Assessment reports are asynchronous. A submitted run can remain pending or running before report JSON becomes available.

Contact and careers endpoints can enforce CAPTCHA validation when Turnstile is configured in the environment.

Status: https://theen.com/api/status/