curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/meals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"eaten_at": "2026-10-26T12:30:00Z",
"meal_type": "lunch",
"description": "Greek yogurt with berries and almonds",
"photo_upload_id": "8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e",
"entry_method": "photo",
"protein_g": 24,
"calories_kcal": 310,
"fiber_g": 6
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
eaten_at: '2026-10-26T12:30:00Z',
meal_type: 'lunch',
description: 'Greek yogurt with berries and almonds',
photo_upload_id: '8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e',
entry_method: 'photo',
protein_g: 24,
calories_kcal: 310,
fiber_g: 6
})
};
fetch('https://sandbox.rx.tera.health/v1/patient/meals', 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/meals"
payload = {
"eaten_at": "2026-10-26T12:30:00Z",
"meal_type": "lunch",
"description": "Greek yogurt with berries and almonds",
"photo_upload_id": "8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e",
"entry_method": "photo",
"protein_g": 24,
"calories_kcal": 310,
"fiber_g": 6
}
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-5d6e-7f70-8a92-1b2c3d4e5f60",
"eaten_at": "2026-10-26T12:30:00Z",
"log_date": "2026-10-26",
"meal_type": "lunch",
"description": "Greek yogurt with berries and almonds",
"photo_url": "https://media.example.com/meal-photos/8e2c4a60?signature=example",
"entry_method": "photo",
"protein_g": 24,
"calories_kcal": 310,
"fiber_g": 6,
"source": "brand_app",
"created_at": "2026-10-26T12:31:04Z",
"updated_at": "2026-10-26T12:31:04Z"
}Log a meal
Macros are optional; send what you have. Updates the day’s protein, calorie and fiber rollups.
Error codes: upload_not_found (422) for an unknown or expired photo_upload_id, meal_plan_item_not_found (422).
Plans: AI + health and fitness coaches (ai_health_fitness), AI only (ai_only).
curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/meals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"eaten_at": "2026-10-26T12:30:00Z",
"meal_type": "lunch",
"description": "Greek yogurt with berries and almonds",
"photo_upload_id": "8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e",
"entry_method": "photo",
"protein_g": 24,
"calories_kcal": 310,
"fiber_g": 6
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
eaten_at: '2026-10-26T12:30:00Z',
meal_type: 'lunch',
description: 'Greek yogurt with berries and almonds',
photo_upload_id: '8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e',
entry_method: 'photo',
protein_g: 24,
calories_kcal: 310,
fiber_g: 6
})
};
fetch('https://sandbox.rx.tera.health/v1/patient/meals', 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/meals"
payload = {
"eaten_at": "2026-10-26T12:30:00Z",
"meal_type": "lunch",
"description": "Greek yogurt with berries and almonds",
"photo_upload_id": "8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e",
"entry_method": "photo",
"protein_g": 24,
"calories_kcal": 310,
"fiber_g": 6
}
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-5d6e-7f70-8a92-1b2c3d4e5f60",
"eaten_at": "2026-10-26T12:30:00Z",
"log_date": "2026-10-26",
"meal_type": "lunch",
"description": "Greek yogurt with berries and almonds",
"photo_url": "https://media.example.com/meal-photos/8e2c4a60?signature=example",
"entry_method": "photo",
"protein_g": 24,
"calories_kcal": 310,
"fiber_g": 6,
"source": "brand_app",
"created_at": "2026-10-26T12:31:04Z",
"updated_at": "2026-10-26T12:31:04Z"
}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"
breakfast, lunch, dinner, snack "lunch"
Set when the patient ate a meal from their plan.
"3c1e8f20-5b7a-4d9c-8e61-0a2b4c6d8e01"
1000"Greek yogurt with berries and almonds"
From POST /v1/patient/meal-photos, after the photo was uploaded. Not returned; read photo_url instead.
"8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e"
How it was entered. photo_ai when the form was pre-filled by POST /v1/patient/meal-photos/{upload_id}/analysis
(send the same photo_upload_id); TeraRx then compares what was saved with the estimate.
manual, photo, photo_ai, text_ai, barcode, plan "manual"
0 <= x <= 50024
0 <= x <= 10000310
x >= 028
x >= 011
x >= 06
x >= 014
x >= 095
Vitamins, minerals and anything else, keyed by nutrient code.
Show child attributes
Show child attributes
{ "calcium_mg": 220 }
50Show child attributes
Show child attributes
Your id for this log. A second log with the same id returns the first one instead of a duplicate.
1 - 128^[\x21-\x7E]+$"meal-77120"
Response
Logged.
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
"0190f5c9-5d6e-7f70-8a92-1b2c3d4e5f60"
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"
breakfast, lunch, dinner, snack "lunch"
Set when the patient ate a meal from their plan.
"3c1e8f20-5b7a-4d9c-8e61-0a2b4c6d8e01"
1000"Greek yogurt with berries and almonds"
How it was entered. photo_ai when the form was pre-filled by POST /v1/patient/meal-photos/{upload_id}/analysis
(send the same photo_upload_id); TeraRx then compares what was saved with the estimate.
manual, photo, photo_ai, text_ai, barcode, plan "manual"
0 <= x <= 50024
0 <= x <= 10000310
x >= 028
x >= 011
x >= 06
x >= 014
x >= 095
Vitamins, minerals and anything else, keyed by nutrient code.
Show child attributes
Show child attributes
{ "calcium_mg": 220 }
50Show child attributes
Show child attributes
Your id for this log. A second log with the same id returns the first one instead of a duplicate.
1 - 128^[\x21-\x7E]+$"meal-77120"
Short-lived link to the photo (expires within minutes). Do not store it.
null