curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/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"
}
'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'
})
};
fetch('https://sandbox.rx.tera.health/v1/patient/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/patient/treatments"
payload = {
"medication_id": "6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f",
"dose_mg": 0.5,
"phase": "titration",
"injection_weekday": 1,
"started_on": "2026-09-28"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"medication": {
"ingredient": "semaglutide",
"product_name": "Wegovy",
"source": "branded",
"route": "injection"
},
"dose_mg": 0.5,
"dose_amount": null,
"dose_unit": null,
"phase": "titration",
"injection_weekday": 1,
"started_on": "2026-09-28",
"treatment_week": 5,
"effective_from": "2026-10-26T14:05:00Z"
}Report my treatment (TeraRx Direct)
Direct patients self-report the GLP-1 they take. Brand patients’ treatment comes from the brand’s prescriber,
so this returns 403 treatment_managed_by_brand for them.
Plans: AI + health and fitness coaches (ai_health_fitness), AI only (ai_only).
curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/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"
}
'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'
})
};
fetch('https://sandbox.rx.tera.health/v1/patient/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/patient/treatments"
payload = {
"medication_id": "6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f",
"dose_mg": 0.5,
"phase": "titration",
"injection_weekday": 1,
"started_on": "2026-09-28"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"medication": {
"ingredient": "semaglutide",
"product_name": "Wegovy",
"source": "branded",
"route": "injection"
},
"dose_mg": 0.5,
"dose_amount": null,
"dose_unit": null,
"phase": "titration",
"injection_weekday": 1,
"started_on": "2026-09-28",
"treatment_week": 5,
"effective_from": "2026-10-26T14:05:00Z"
}Authorizations
A 15-minute token bound to one patient and one enrollment, issued by POST /v1/oauth/token with the
token-exchange grant. Treat it as opaque. When it expires, exchange a fresh assertion; there is no refresh token.
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 - 255Body
TeraRx Direct only. The patient reports the GLP-1 they take; brand patients get their treatment from the brand.
"6f1d2c3b-4a59-4e8f-9d7c-1b2a3c4d5e6f"
x <= 1000.5
pending_start, titration, maintenance, taper, off_ramp, paused, stopped "titration"
0 <= x <= 61
"2026-09-28"
Response
The reported treatment.
The patient's current treatment as the patient sees it.
Show child attributes
Show child attributes
0.5
pending_start, titration, maintenance, taper, off_ramp, paused, stopped "titration"
null
null
1
"2026-09-28"
5
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"