curl --request POST \
--url https://sandbox.rx.tera.health/v1/patient/meal-plan/items/{item_id}/swap \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"option_id": "opt_1",
"reason": "I don't like fish"
}
EOFconst options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({option_id: 'opt_1', reason: 'I don\'t like fish'})
};
fetch('https://sandbox.rx.tera.health/v1/patient/meal-plan/items/{item_id}/swap', 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-plan/items/{item_id}/swap"
payload = {
"option_id": "opt_1",
"reason": "I don't like fish"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "4d2f9a31-6c8b-4e0d-9f72-1b3c5d7e9f02",
"day_index": 0,
"meal_type": "dinner",
"sort_order": 0,
"title": "Chicken and quinoa bowl",
"description": "Grilled chicken, quinoa, roasted vegetables",
"protein_g": 38,
"calories_kcal": 480,
"details": {
"prep_minutes": 25
},
"recipe_id": null,
"swap": {
"original_title": "Salmon with quinoa",
"reason": "I don't like fish",
"swapped_by": "ai",
"swapped_at": "2026-10-26T11:02:00Z"
}
}Swap a meal
Replaces the meal with one of the options. The original meal and the reason are kept on the item and shown to
the care team. Error codes: swap_option_expired (409), swap_option_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/meal-plan/items/{item_id}/swap \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"option_id": "opt_1",
"reason": "I don't like fish"
}
EOFconst options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({option_id: 'opt_1', reason: 'I don\'t like fish'})
};
fetch('https://sandbox.rx.tera.health/v1/patient/meal-plan/items/{item_id}/swap', 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-plan/items/{item_id}/swap"
payload = {
"option_id": "opt_1",
"reason": "I don't like fish"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "4d2f9a31-6c8b-4e0d-9f72-1b3c5d7e9f02",
"day_index": 0,
"meal_type": "dinner",
"sort_order": 0,
"title": "Chicken and quinoa bowl",
"description": "Grilled chicken, quinoa, roasted vegetables",
"protein_g": 38,
"calories_kcal": 480,
"details": {
"prep_minutes": 25
},
"recipe_id": null,
"swap": {
"original_title": "Salmon with quinoa",
"reason": "I don't like fish",
"swapped_by": "ai",
"swapped_at": "2026-10-26T11:02: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
Optional on this action. When sent, it works as on creating requests (24 hours, same body).
8 - 255Path Parameters
Body
Response
The swapped meal.
"3c1e8f20-5b7a-4d9c-8e61-0a2b4c6d8e01"
Day in the plan's cycle, starting at 0 on starts_on.
x >= 00
breakfast, lunch, dinner, snack "lunch"
0
"Greek yogurt bowl"
Show child attributes
Show child attributes
"Nonfat Greek yogurt with berries and almonds"
24
310
A library recipe, when the meal comes from one. Read it with GET /v1/patient/library/{library_item_id}.
null
Set when the meal was swapped. The original meal is kept.
Show child attributes
Show child attributes
The patient's rating of this meal, or null.
Show child attributes
Show child attributes