curl --request POST \
--url https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/workouts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"started_at": "2026-10-26T07:00:00Z",
"activity_type": "walk",
"duration_min": 30,
"external_id": "workout-5531"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
started_at: '2026-10-26T07:00:00Z',
activity_type: 'walk',
duration_min: 30,
external_id: 'workout-5531'
})
};
fetch('https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/workouts', 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}/workouts"
payload = {
"started_at": "2026-10-26T07:00:00Z",
"activity_type": "walk",
"duration_min": 30,
"external_id": "workout-5531"
}
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-6e7f-7081-9ba3-2c3d4e5f6071",
"external_id": "workout-5531",
"log_date": "2026-10-26",
"created_at": "2026-10-26T07:40:00Z",
"updated_at": "2026-10-26T07:40:00Z"
}Send a workout log
A workout your app already recorded. 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}/workouts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"started_at": "2026-10-26T07:00:00Z",
"activity_type": "walk",
"duration_min": 30,
"external_id": "workout-5531"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
started_at: '2026-10-26T07:00:00Z',
activity_type: 'walk',
duration_min: 30,
external_id: 'workout-5531'
})
};
fetch('https://sandbox.rx.tera.health/v1/enrollments/{enrollment_id}/workouts', 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}/workouts"
payload = {
"started_at": "2026-10-26T07:00:00Z",
"activity_type": "walk",
"duration_min": 30,
"external_id": "workout-5531"
}
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-6e7f-7081-9ba3-2c3d4e5f6071",
"external_id": "workout-5531",
"log_date": "2026-10-26",
"created_at": "2026-10-26T07:40:00Z",
"updated_at": "2026-10-26T07:40:00Z"
}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"
For example strength, walk, run, yoga, cycling.
50"strength"
Your own identifier, printable ASCII without spaces.
1 - 128^[\x21-\x7E]+$"workout-5531"
1 <= x <= 60035
1 <= x <= 106
"1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d"
100Show child attributes
Show child attributes
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"