curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/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": "strength",
"duration_min": 35,
"perceived_effort": 6,
"workout_plan_item_id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d",
"sets": [
{
"exercise_id": "5a7c9e1b-3d5f-4a8c-9e2b-4d6f8a0c2e4f",
"name": "Goblet squat",
"reps": 10,
"weight_kg": 12
}
]
}
'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: 'strength',
duration_min: 35,
perceived_effort: 6,
workout_plan_item_id: '1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d',
sets: [
{
exercise_id: '5a7c9e1b-3d5f-4a8c-9e2b-4d6f8a0c2e4f',
name: 'Goblet squat',
reps: 10,
weight_kg: 12
}
]
})
};
fetch('https://sandbox.rx.tera.health/v1/patient/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/patient/workouts"
payload = {
"started_at": "2026-10-26T07:00:00Z",
"activity_type": "strength",
"duration_min": 35,
"perceived_effort": 6,
"workout_plan_item_id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d",
"sets": [
{
"exercise_id": "5a7c9e1b-3d5f-4a8c-9e2b-4d6f8a0c2e4f",
"name": "Goblet squat",
"reps": 10,
"weight_kg": 12
}
]
}
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",
"started_at": "2026-10-26T07:00:00Z",
"log_date": "2026-10-26",
"activity_type": "strength",
"duration_min": 35,
"completed": true,
"perceived_effort": 6,
"workout_plan_item_id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d",
"sets": [
{
"exercise_id": "5a7c9e1b-3d5f-4a8c-9e2b-4d6f8a0c2e4f",
"name": "Goblet squat",
"reps": 10,
"weight_kg": 12
}
],
"source": "brand_app",
"created_at": "2026-10-26T07:40:00Z",
"updated_at": "2026-10-26T07:40:00Z"
}Log a workout
Updates the day’s workout minutes. Link workout_plan_item_id when the workout came from the plan.
Plans: AI + health and fitness coaches (ai_health_fitness), AI only (ai_only).
curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/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": "strength",
"duration_min": 35,
"perceived_effort": 6,
"workout_plan_item_id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d",
"sets": [
{
"exercise_id": "5a7c9e1b-3d5f-4a8c-9e2b-4d6f8a0c2e4f",
"name": "Goblet squat",
"reps": 10,
"weight_kg": 12
}
]
}
'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: 'strength',
duration_min: 35,
perceived_effort: 6,
workout_plan_item_id: '1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d',
sets: [
{
exercise_id: '5a7c9e1b-3d5f-4a8c-9e2b-4d6f8a0c2e4f',
name: 'Goblet squat',
reps: 10,
weight_kg: 12
}
]
})
};
fetch('https://sandbox.rx.tera.health/v1/patient/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/patient/workouts"
payload = {
"started_at": "2026-10-26T07:00:00Z",
"activity_type": "strength",
"duration_min": 35,
"perceived_effort": 6,
"workout_plan_item_id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d",
"sets": [
{
"exercise_id": "5a7c9e1b-3d5f-4a8c-9e2b-4d6f8a0c2e4f",
"name": "Goblet squat",
"reps": 10,
"weight_kg": 12
}
]
}
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",
"started_at": "2026-10-26T07:00:00Z",
"log_date": "2026-10-26",
"activity_type": "strength",
"duration_min": 35,
"completed": true,
"perceived_effort": 6,
"workout_plan_item_id": "1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d",
"sets": [
{
"exercise_id": "5a7c9e1b-3d5f-4a8c-9e2b-4d6f8a0c2e4f",
"name": "Goblet squat",
"reps": 10,
"weight_kg": 12
}
],
"source": "brand_app",
"created_at": "2026-10-26T07:40:00Z",
"updated_at": "2026-10-26T07:40: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
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
For example strength, walk, run, yoga, cycling.
50"strength"
1 <= x <= 60035
1 <= x <= 106
"1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d"
100Show child attributes
Show child attributes
Your own identifier, printable ASCII without spaces.
1 - 128^[\x21-\x7E]+$"workout-5531"
Response
Logged.
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
For example strength, walk, run, yoga, cycling.
50"strength"
"0190f5c9-6e7f-7081-9ba3-2c3d4e5f6071"
A calendar date in the patient's time zone.
"2026-10-26"
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"
When the log was last corrected; the same as created_at until then.
"2026-10-26T14:05:00Z"
1 <= x <= 60035
1 <= x <= 106
"1b3d5f7a-9c2e-4a6b-8d0f-2e4a6c8e0b2d"
100Show child attributes
Show child attributes
Your own identifier, printable ASCII without spaces.
1 - 128^[\x21-\x7E]+$"workout-5531"