Incarna

Permanently delete a workout owned by this user, including its blocks. If this was the only workout in its program, that program is deleted too. This notifies the user's app and devices.

delete_workout

Clone an existing meal you can see (your own, one assigned to you, or a shared-catalog one) into a new copy assigned to yourself or to a trainee — e.g. the "pizza diet" meal you made for one trainee, duplicated for another. You become the author of the copy; the original is untouched.

duplicate_saved_meal

Edit a food you authored or are assigned — fails on the shared catalog or anyone else’s food. traineeId only affects which nutrition-access rule is checked (pass the trainee this food belongs to); the edit itself is still only allowed if you authored it or it is assigned to you.

update_food

Edit an exercise YOU created in your own private library (see list_exercises' createdByName) — fails on any exercise you don't own, including the shared built-in catalog ones. Provide just the fields to change; everything else stays as-is.

update_my_exercise

Get this user's current daily nutrition target (calories + protein/carbs/fat in grams), or null if none is set yet. Requires an active Plus/Coach plan, or being within the account’s first free month — fails otherwise.

get_nutrition_target

Get the full detail of one program: its dates and the ordered list of workouts placed in it, each with its own scheduled days.

get_program

Get a trainee's current daily nutrition target — same data as get_nutrition_target. Requires BOTH sides to have nutrition unlocked: you on a Coach plan (or on the free plan with exactly one trainee, if that trainee has their own Plus access), AND the trainee on their own Plus-or-better plan. If the trainee is the one missing it, the error explains that so you can relay it to them.

get_trainee_nutrition_target

Get the full detail of one of a trainee's programs.

get_trainee_program

Get the full detail of one of a trainee's workouts.

get_trainee_workout

Get the full detail of one of a trainee's workout sessions.

get_trainee_workout_log

Get the full detail of one workout, including its blocks and exercises.

get_workout

Get the full detail of one workout session: every set logged, with the exercise name and both the planned and actual reps/weight/duration/distance — what actually happened, not just what was prescribed.

get_workout_log

List exercises you can use: the shared catalog plus your own private exercises. Optionally filtered by category and/or tracking type.

list_exercises

List the people you're allowed to message — your coach(es) and/or trainee(s) with an accepted coaching relationship.

list_messaging_contacts

List the meals you've authored — omit traineeId to see all of them, or pass one to narrow to what you created for that specific trainee.

list_saved_meals

List this user's logged meals, most recent first — one summary per meal (meal type, logged items, and totals for calories/protein/carbs/fat). Use this to see actual nutrition adherence before adjusting a target. Requires an active Plus/Coach plan, or being within the account’s first free month — fails otherwise.

list_nutrition_logs

List this user's programs — a program is a named, optionally dated collection of one or more workouts (a multi-week split, or just a single standalone workout wrapped on its own).

list_programs

List a trainee's logged meals, most recent first — same data as list_nutrition_logs. Requires BOTH sides to have nutrition unlocked: you on a Coach plan (or on the free plan with exactly one trainee, if that trainee has their own Plus access), AND the trainee on their own Plus-or-better plan. If the trainee is the one missing it, the error explains that so you can relay it to them.

list_trainee_nutrition_logs

List a trainee's programs — same data as list_programs, for a trainee you coach.

list_trainee_programs

List a trainee's workout session history — same data as list_workout_logs.

list_trainee_workout_logs

List a trainee's workouts — same data as list_workouts, for a trainee you coach.

list_trainee_workouts

List the trainees this user coaches (accepted coaching relationships only).

list_my_trainees

List this user's completed/abandoned workout sessions, most recent first — one summary per session (status, RPE rating 1-5, free-text feedback notes, and completed/skipped/failed set counts). Use this to see how training has actually gone before adjusting a workout: RPE trending low with everything COMPLETED suggests it is time to progress the load; frequent SKIPPED/FAILED sets or high RPE suggests a deload or an exercise swap. Call get_workout_log for the planned-vs-actual detail of one session.

list_workout_logs

List this user's workouts (each workout is a single session, e.g. "Push day").

list_workouts

Replace the name and full item list of a meal you authored or are assigned — fails otherwise. `items` fully replaces the previous ones.

update_saved_meal

Update an existing program owned by this user. If `workouts` is provided, it fully replaces (removes and recreates) the previous placements — reordering, rescheduling, adding, or removing a workout from the program all go through this one field. Removing a workout that only exists in this program is refused — delete_workout it directly instead, or place it in another program first. Updating a program notifies this user's app and devices.

update_program

Update one of a trainee's existing programs (same shape as update_program; `workouts` fully replaces the previous placements). This writes into the trainee's account and notifies them.

update_program_for_trainee

Update one of a trainee's existing workouts (same shape as update_workout; `blocks` fully replaces the previous blocks). This writes into the trainee's account and notifies them.

update_workout_for_trainee

Update an existing workout owned by this user. If `blocks` is provided, it fully replaces (deletes and recreates) the previous blocks, and estimatedDurationSeconds is recomputed from them automatically (not settable here). Updating a workout notifies this user's app and devices.

update_workout

Send a chat message to one of your coaches or trainees (see list_messaging_contacts). To message several people, call this once per recipient — each conversation is always 1:1.

send_message

Favorite or unfavorite a food or a meal, for yourself or for a trainee — drives that account's quick-add favorites row in the app.

set_nutrition_favorite

Set this user's daily nutrition target. Replaces the previous target entirely (all four fields required) — call get_nutrition_target first if you need the current values to compute an adjustment (e.g. +20g protein) rather than setting a target from scratch. Requires an active Plus/Coach plan, or being within the account’s first free month — fails otherwise.

set_nutrition_target

Star or unstar a program as the one featured at the top of the Programs list / Home hero, for yourself or for a trainee. Starring one automatically un-stars whatever that account had favorited before (only one at a time) — this is unrelated to nutrition access, no plan required.

set_program_favorite

Set a trainee's daily nutrition target (same replace-entirely semantics as set_nutrition_target — call get_trainee_nutrition_target first for the current values). Requires BOTH sides to have nutrition unlocked: you on a Coach plan (or on the free plan with exactly one trainee, if that trainee has their own Plus access), AND the trainee on their own Plus-or-better plan. If the trainee is the one missing it, the error explains that so you can relay it to them.

set_nutrition_target_for_trainee