curl --request POST \
--url https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/symptoms \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"occurred_at": "2026-10-26T19:45:00Z",
"symptom": "constipation",
"severity": 3,
"external_id": "sym-20931"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
occurred_at: '2026-10-26T19:45:00Z',
symptom: 'constipation',
severity: 3,
external_id: 'sym-20931'
})
};
fetch('https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/symptoms', 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}/symptoms"
payload = {
"occurred_at": "2026-10-26T19:45:00Z",
"symptom": "constipation",
"severity": 3,
"external_id": "sym-20931"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "0190f5c9-7f80-7192-8cb4-3d4e5f607182",
"external_id": "sym-20931",
"log_date": "2026-10-26",
"created_at": "2026-10-26T19:46:10Z",
"updated_at": "2026-10-26T19:46:10Z"
}Send a symptom log
A symptom your app or clinicians already recorded. Alert rules run on it exactly as on a patient’s own log,
so a red flag here raises a clinical flag. A repeated external_id returns the first receipt with 200.
Scope: logs:write.
curl --request POST \
--url https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/symptoms \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"occurred_at": "2026-10-26T19:45:00Z",
"symptom": "constipation",
"severity": 3,
"external_id": "sym-20931"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
occurred_at: '2026-10-26T19:45:00Z',
symptom: 'constipation',
severity: 3,
external_id: 'sym-20931'
})
};
fetch('https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/symptoms', 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}/symptoms"
payload = {
"occurred_at": "2026-10-26T19:45:00Z",
"symptom": "constipation",
"severity": 3,
"external_id": "sym-20931"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "0190f5c9-7f80-7192-8cb4-3d4e5f607182",
"external_id": "sym-20931",
"log_date": "2026-10-26",
"created_at": "2026-10-26T19:46:10Z",
"updated_at": "2026-10-26T19:46:10Z"
}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
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
A symptom code, for example nausea, vomiting, diarrhea, constipation, reflux, fatigue, abdominal_pain.
These codes are red flags at any severity: chest_pain, difficulty_breathing, fainting,
severe_abdominal_pain, persistent_vomiting, blood_in_vomit, blood_in_stool, yellow_skin_or_eyes,
severe_dehydration, allergic_reaction, swelling_face_or_throat, vision_changes, suicidal_thoughts,
self_harm. Any symptom at severity 5 is one too. A brand's own alert rules can add codes.
^[a-z][a-z0-9_]*$"nausea"
1 <= x <= 52
Your own identifier, printable ASCII without spaces.
1 - 128^[\x21-\x7E]+$"sym-20931"
The patient's own words. Read by the care team and, on a clinical flag, the prescriber.
1000"Mild, after dinner"
Response
Already received; the first receipt.
What a brand server gets back for a log. The values stay with the care team.
"0190f5c9-5d6e-7f70-8a92-1b2c3d4e5f60"
Your own identifier, printable ASCII without spaces.
1 - 128^[\x21-\x7E]+$"meal-77120"
A calendar date in the patient's time zone.
"2026-10-26"
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
When the log was last corrected; the same as created_at until then.
"2026-10-26T14:05:00Z"