curl --request POST \
--url https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/treatments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"medication_id": "6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f",
"dose_mg": 0.5,
"phase": "titration",
"injection_weekday": 1,
"started_on": "2026-09-28",
"effective_from": "2026-10-26T00:00:00Z",
"note": "Step up to 0.5 mg per titration schedule"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
medication_id: '6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f',
dose_mg: 0.5,
phase: 'titration',
injection_weekday: 1,
started_on: '2026-09-28',
effective_from: '2026-10-26T00:00:00Z',
note: 'Step up to 0.5 mg per titration schedule'
})
};
fetch('https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/treatments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/treatments"
payload = {
"medication_id": "6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f",
"dose_mg": 0.5,
"phase": "titration",
"injection_weekday": 1,
"started_on": "2026-09-28",
"effective_from": "2026-10-26T00:00:00Z",
"note": "Step up to 0.5 mg per titration schedule"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Update the treatment mirror
Send the treatment whenever your prescriber sets or changes it: a new dose, a phase change, a pause or a stop. Each call appends a version and the latest becomes current. TeraRx never changes a dose; protocols are redrafted against the new dose by the rule matrix.
Error codes: unknown_medication, validation_failed (422); invalid_status_transition (409) on an ended enrollment.
Scope: enrollments:write.
curl --request POST \
--url https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/treatments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"medication_id": "6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f",
"dose_mg": 0.5,
"phase": "titration",
"injection_weekday": 1,
"started_on": "2026-09-28",
"effective_from": "2026-10-26T00:00:00Z",
"note": "Step up to 0.5 mg per titration schedule"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
medication_id: '6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f',
dose_mg: 0.5,
phase: 'titration',
injection_weekday: 1,
started_on: '2026-09-28',
effective_from: '2026-10-26T00:00:00Z',
note: 'Step up to 0.5 mg per titration schedule'
})
};
fetch('https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/treatments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/treatments"
payload = {
"medication_id": "6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f",
"dose_mg": 0.5,
"phase": "titration",
"injection_weekday": 1,
"started_on": "2026-09-28",
"effective_from": "2026-10-26T00:00:00Z",
"note": "Step up to 0.5 mg per titration schedule"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Authorizations
A brand's server, one OAuth client per brand and environment. Get a token with the
client_credentials grant and send it as Authorization: Bearer <token>. Tokens last 1 hour.
A brand server reads status and ids only; it never reads clinical content. A platform partner holds one
client for all its brands and gets one token per brand, naming it with tenant_id.
Headers
A unique key per logical request, for example a UUID. Retrying with the same key and the same body
within 24 hours returns the first response (with Idempotent-Replayed: true) instead of creating a duplicate.
The same key with a different body is refused with 422 idempotency_key_reused.
8 - 255Path Parameters
Body
The medication, dose and schedule your prescriber set. TeraRx mirrors it and never changes it. Each call adds a version; the latest is the current treatment and earlier ones are the dose history.
From GET /v1/medications.
"6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f"
x <= 1000.5
pending_start, titration, maintenance, taper, off_ramp, paused, stopped "titration"
The dose as prescribed, when it is not in mg (for example 20 units of a compounded vial).
20
20"units"
A custom titration ladder or microdosing schedule.
{ "steps": [ { "from_week": 1, "dose_mg": 0.25 }, { "from_week": 5, "dose_mg": 0.5 } ] }
0 is Sunday. Drives injection-day reminders.
0 <= x <= 61
First dose. The treatment week is counted from it.
"2026-09-28"
When this dose takes effect. Defaults to now.
"2026-10-26T14:05:00Z"
Visible to the care team only.
1000"Step up to 0.5 mg per titration schedule"
Response
The new current treatment.
"0190f5c7-1a2b-7c3d-8e4f-5a6b7c8d9e0f"
Show child attributes
Show child attributes
0.5
pending_start, titration, maintenance, taper, off_ramp, paused, stopped "titration"
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
Set by the API from the caller. brand_api for brand servers, brand_app for patient tokens issued to a brand.
app, brand_app, brand_api, wearable, coach, ai, system "brand_app"
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
null
null
null
1
"2026-09-28"
Week of treatment today, counted from started_on (week 1 is the first 7 days).
5
"Step up to 0.5 mg per titration schedule"