Patientsv1
Create Patient
Registers a patient (subject) whose voice will be analyzed over time. A patient is the anchor for longitudinal baselines — every analysis is scored against this subject's own history, not a population average. No PHI is required: pass a pseudonymous external_id from your own system.
POSTpatientscontent_copy
Headers
Authorization
RequiredBearer token — your secret API key. Create one in the dashboard under Developers → API Keys.
Content-Type
application/json for metadata requests, or multipart/form-data when uploading raw audio.
Body Parameters
external_idstringRequired
Your own pseudonymous identifier for the patient. Voxtar never needs a name, MRN, or date of birth — tokenize on your side.
sex_at_birthstringOptional
Optional. One of male | female | unspecified. Used only to select the correct acoustic reference model.
age_bandstringOptional
Optional coarse band (e.g. 18-39, 40-64, 65+). Sharpens baseline modelling without storing an exact DOB.
metadataobjectOptional
Optional free-form key/value pairs echoed back on every analysis for this patient.
{ "cohort": "asthma-pilot", "site": "clinic-04" }
Response
201 Createdapplication/json
{"id": "pt_8kQ2v9","external_id": "subject-1042","sex_at_birth": "female","age_band": "40-64","baseline_status": "pending","created_at": "2026-07-11T09:24:00Z"}