curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/meal-photos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"content_type": "image/jpeg",
"content_length": 1843200
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({content_type: 'image/jpeg', content_length: 1843200})
};
fetch('https://sandbox.rx.tera.health/v1/patient/meal-photos', 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/meal-photos"
payload = {
"content_type": "image/jpeg",
"content_length": 1843200
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"upload_id": "8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e",
"upload_url": "https://uploads.example.com/meal-photos/8e2c4a60?signature=example",
"method": "PUT",
"headers": {
"Content-Type": "image/jpeg"
},
"expires_at": "2026-10-26T14:15:00Z"
}Start a meal photo upload
Returns a pre-signed URL. Upload the photo there, then send upload_id as photo_upload_id on the meal log.
An upload not attached to a meal within 1 hour is deleted.
Plans: AI + health and fitness coaches (ai_health_fitness), AI only (ai_only).
curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/meal-photos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"content_type": "image/jpeg",
"content_length": 1843200
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({content_type: 'image/jpeg', content_length: 1843200})
};
fetch('https://sandbox.rx.tera.health/v1/patient/meal-photos', 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/meal-photos"
payload = {
"content_type": "image/jpeg",
"content_length": 1843200
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"upload_id": "8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e",
"upload_url": "https://uploads.example.com/meal-photos/8e2c4a60?signature=example",
"method": "PUT",
"headers": {
"Content-Type": "image/jpeg"
},
"expires_at": "2026-10-26T14:15: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
Response
Upload ready.
"8e2c4a60-1f3b-4d5e-9a7c-0b2d4f6a8c1e"
Pre-signed URL. Upload the bytes with method and headers before expires_at.
"https://uploads.example.com/meal-photos/8e2c4a60?signature=example"
"PUT"Headers to send with the upload, exactly as given.
Show child attributes
Show child attributes
{ "Content-Type": "image/jpeg" }
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"