The athlete's id, name and the coach teams they belong to.

Sessions scheduled between two dates (YYYY-MM-DD, inclusive), oldest first.

Defaults to the last days_back days. Future dates work too, which is how to review a planned block. Each row has the ids needed by the other tools.

One session: title, notes, blocks, exercises with prescription, results and video.

team_id is optional; the right team is found automatically.

Per-set prescribed and logged values for one exercise of a session.

Find exercises in the TrainHeroic library by name (all words must match).

Returns id, title, what the exercise tracks (e.g. "Reps @ Weight (lb)") and the video link. The library is cached for 24h; pass refresh=True to reload.

Full library entry for one exercise: technique notes, video, tracked params.

Find circuits (predefined exercise groups) in the library by name.

Exercises the athlete used recently.

Circuits the athlete used recently.

Last performance, personal record and working max for an exercise.

Personal records for an exercise by rep count.

Current working max for an exercise.

Readiness answers (sleep, mood, energy, stress, soreness) for saved workouts.

Scores run from 1 (worst) to 5 (best).

Answer one readiness question for a saved workout; score 1 (worst) to 5 (best).

Comment thread of a session (coach and athlete messages).

Team leaderboard for a session.

Save the athlete's session notes, RPE (1-10) and rating.

This does not log per-set results or mark the session completed; that is done in the TrainHeroic app.

Create an empty personal session on a date (YYYY-MM-DD).

Append library exercises to a personal session, each in its own block.

Returns the ids needed by set_prescription and update_block.

Set sets and per-set targets for one exercise of a session you own.

Each target is one value for all sets or a list with one value per set, e.g. sets=4, reps=8, weight_kg=[30, 35, 40, 40]. Targets and the set count you leave out keep their planned values, so weight_kg=42.5 alone only changes weights. Reps are whole numbers; write "per side" or tempo cues in instruction. Only targets the exercise tracks are accepted (see tracks in get_workout).

Rename a session and/or set its notes. Omitted fields stay unchanged.

Rename a block and/or set its instruction (e.g. warm-up circuit, rest times).

Delete a session from the calendar.

Append library exercises to an existing block, turning it into a superset.

Set their targets afterwards with set_prescription.

Create a complete personal session in one call.

Exercises go into blocks in the given order, each with its prescription and cue. Exercises sharing a superset label are placed together in one block. If any step fails the half-built session is deleted.

Remove one exercise from a session; a block left empty is removed too.

Remove a whole block (all its exercises) from a session.

Copy a session's plan to another date on your personal calendar.

Blocks, supersets, sets/reps/weights, cues and notes are copied; logged results are not. Works for coach sessions too, as long as they are visible. For personal sessions the app writes values typed while logging back into the plan, so a logged personal session copies those values (the result says so).

Reschedule a personal session that has no logged results yet.

TrainHeroic offers no reschedule call for personal calendars, so the session is copied to to_date and the original deleted: its ids change.