search_exercises
Search exercises
Search 873 exercises by name with muscle/equipment/level filters. Rows are lean (name, ext_id, equipment, level, muscles) — enough to pick one; get_exercise returns instructions and media. Paginates: pass next_cursor back as `cursor`.
輸入參數q必填levellimitcursorfieldsmuscleequipment
Fetch one exercise by name, id, or random.
輸入參數idnamerandom
resolve_exercise
Resolve exercise
Resolve an exercise name into primary/secondary muscle layers for rendering.
輸入參數exercise必填
List all 23 supported muscle slugs with anatomical names.
無需輸入參數。
generate_muscle_image
Generate muscle image
Render an SVG diagram of the human body with muscles highlighted in arbitrary colors. Returns SVG.
輸入參數viewgenderlayers必填
list_routines
List routines
Browse the curated workout routine library (PPL, upper/lower, full-body, 5x5, etc.). Filter by difficulty, goal, split_type, days_per_week. Returns minimal list.
輸入參數goallimitdifficultysplit_typedays_per_week
Fetch a single curated routine by slug with all days + slots fully expanded (exercises, sets, reps ranges, rest, superset groupings). The 'give me a full program' tool.
輸入參數slug必填
instantiate_routine
Instantiate routine
Schedule the signed-in user's routine into planned workouts from start_date. Coach assignment of another user is REST-only.
輸入參數routine_id必填start_date必填cadence_daysidempotency_key
Search food products by name (Open Food Facts + USDA). Returns macros per 100g.
輸入參數q必填localepage_size
lookup_barcode
Lookup barcode
Lookup a food product by EAN/UPC barcode.
輸入參數barcode必填
Log a workout with exercise sets (strength or cardio unified). Requires an app user context.
輸入參數date必填setstitleprimary_sportidempotency_key
List the current app user's workouts (most recent first).
輸入參數limitdate_todate_from
Log a meal (calories + macros + optional ingredients) for the current app user.
輸入參數date必填fatsname必填carbsproteincalories必填meal_typeidempotency_key
List the current app user's meals for a date range.
輸入參數date_todate_from
Log water intake (ml) for the current app user.
輸入參數date必填amount_ml必填idempotency_key
log_body_metric
Log body metric
Log a body measurement. metric_type: weight (kg), height (cm), body_fat (%), muscle_mass (kg), waist/chest/bicep/forearm/hip/thigh/calf/neck/shoulder (cm), bmi, resting_hr (bpm). Logging weight enables bodyweight-inclusive volume analytics.
輸入參數date必填unit必填notesvalue必填metric_type必填idempotency_key
get_body_metrics
Get body metrics
List the current app user's body metrics / measurements (weight, height, bicep, body fat, etc.), most recent first. Filter by metric_type (e.g. 'weight', 'bicep') and/or a date range. Requires an app user context.
輸入參數tofromlimitmetric_type
upsert_profile
Upsert profile
Upsert the current app user's fitness profile. Set `timezone` first: every daily total, streak and adherence window is bucketed by it and defaults to UTC. `weight` doubles as the fallback bodyweight for bodyweight-inclusive volume when no dated weight metric exists.
輸入參數goalheightweightlanguagetimezonediet_typeunit_systemactive_sportsmeals_per_daydaily_fats_goaldaily_carbs_goaldaily_fiber_goal另有 5 個
Get the current app user's fitness profile (height, weight, macro + water goals, diet, active sports). Requires an app user context.
無需輸入參數。
Log a cardio activity (run/bike/swim/etc.) for the current app user. Supports duration, distance, HR, power, calories.
輸入參數date必填notessport必填titleavg_hrcaloriesdistance_midempotency_keyduration_seconds
get_cardio_activities
Get cardio activities
List the current app user's cardio activities (most recent first).
輸入參數limitdate_todate_from
ai_parse_meal
Ai parse meal
Parse free-text meal description ('2 eggs and toast with butter') into structured items with grams + macros.
輸入參數text必填locale
ai_photo_macros
Ai photo macros
Analyze a meal image and estimate foods + macros. Pass exactly one of image_url or image_base64. Vision model, capped separately from the text AI budget (free tier 1/mo).
輸入參數image_urlimage_base64
Draft a meal plan. Not medical advice. confirm:true required. Pass health constraints so the draft can honour them.
輸入參數days必填goalhealthconfirm必填diet_typedaily_calories
ai_workout_plan
Ai workout plan
Draft a workout plan. Not medical advice. confirm:true required. Pass health constraints so the draft can honour them.
輸入參數goalhealthconfirm必填experiencedays_per_week必填
get_muscle_recovery
Get muscle recovery
Per-muscle 7-day recovery % (Fitbod parity) — the 'what should I train today?' input. Recommends fresh muscles. Pass include_bodyweight=true to add the user's bodyweight to bodyweight exercises so recovery reflects real load.
輸入參數include_bodyweight
get_nutrition_daily
Get nutrition daily
Per-day calories, macros, fiber/sugar/sodium/alcohol, water, targets and adherence % over a date range (default: last 7 days). The 'how am I tracking today?' tool. Requires X-App-User-Id.
輸入參數date_todate_from
List the current app user's water intake entries for a date range. Requires X-App-User-Id.
輸入參數datedate_todate_from
Correct a previously logged meal — name, macros, nutrients, portion, date or meal_type. Pass only the fields you want to change. Requires X-App-User-Id.
輸入參數datefatsnamecarbsfibersugarsodiumalcoholmeal_id必填proteincaloriesmeal_type另有 2 個
Delete a logged meal by id (soft delete, 30-day recovery window). Requires X-App-User-Id.
輸入參數meal_id必填
Correct sets already logged, by set id (log_workout returns them). Relabel the exercise, fix weight/reps/rpe, mark completed, add notes, or delete. Selection and change are separate, so a subset can be relabelled. Adding a set is log_workout, not this.
輸入參數rperepsnotesdeleteweightset_ids必填exercisecompleted
delete_workout
Delete workout
Delete a logged workout and its sets by id (soft delete, 30-day recovery window).
輸入參數workout_id必填
Export the signed-in user's data as JSON. Pass `domains` (e.g. meals,workouts) or confirm:true for a full copy. Identity comes from the token, never a caller-supplied user id.
輸入參數confirmdomains
What changed since a cursor, including DELETES, which a list read cannot show. Returns {seq, entity, id, action}. Pass the last seq back as `since` on the next call to receive only entries after it; omit `since` for a first sync. seq is a global counter: gaps in your feed are other accounts' events, not lost data. Judge completeness from has_more, not seq.
輸入參數limitsinceentities
my_training_context
My training context
Returns a slice of the signed-in user's training picture. Default domains are workouts and today's nutrition. Pass `domains` to add checkin, notes or profile, or `domains=all`. Identity comes from the token, not a caller-supplied user id.
輸入參數domainsworkout_limit
Any progression metric for the current user — pick one in `metric`. training_load is acute:chronic (>1.5 ramping too fast, <0.8 detraining); muscle_recovery is per-muscle freshness; correlate takes metric_a vs metric_b. Only completed sets count.
輸入參數todaysfromsportbucketmethodmetric必填windowgoal_idexercisegroup_bymetric_a另有 2 個