Add one or more athletes to a group. Moving an athlete = add to the new group + remove from the old one.

Append a comment to a calendar note's thread. Repeating the call posts a duplicate. Note ID from tp_list_notes or tp_create_note.

Append a comment to a workout's thread - visible to both athlete and coach. Repeating the call posts a duplicate. For a private note use tp_set_workout_note instead.

Get workout analysis: metrics, zones, laps. Saves full time-series to JSON file.

Apply a training plan to an athlete's calendar from a start date by copying each plan workout (with structure) to start_date + its relative day. Targets the athlete given via the athlete parameter.

Check auth status. Use only when other tools return auth errors.

Copy a workout to a new date. Copies structure, description, planned fields.

Mark a date range as unavailable for training (or limited to certain sports). limited=false means fully unavailable; with limited=true, sport_types lists the sports that REMAIN available. Returns availability_id, needed for tp_delete_availability.

Add a bike or shoes to the athlete's equipment list. type is 'bike' or 'shoe'; bike-only fields are rejected on shoes. The API returns no ID on create - verify with tp_get_equipment afterwards.

Create a race/event with priority (A/B/C) and CTL target.

Create a new athlete group.

Create an empty workout library (a folder for reusable templates). Returns library_id; add templates with tp_create_library_item.

Save a workout template to a library.

Create a calendar note.

Create a structured strength/gym workout on the athlete's calendar. Blocks of exercises (from tp_search_exercises) with sets and parameters (Reps, WeightKg, Duration, …).

Create a planned workout with optional simplified interval structure or native TrainingPeaks structured_workout payload. Duration is auto-computed only from simplified structure when not provided.

Create a NEW per-sport zone set for an athlete that has none for that sport (use tp_update_ftp/hr_zones/speed_zones to change an EXISTING set). Bands are computed by TrainingPeaks' calculator for the chosen method (see tp_get_zone_methods). Returns ZONES_EXIST if the set is already present, or TEST_BASED_METHOD for test-derived methods (Distance/Time) — those are set up via a test in the TP UI.

Remove an availability entry so those dates become plannable again. availability_id from tp_get_availability or the create response.

Delete equipment.

Permanently delete a race/event from the calendar - irreversible. Event ID from tp_get_events. Calendar workouts are separate: delete those with tp_delete_workout.

Delete an athlete group (the grouping only — athletes are not deleted). The default group cannot be deleted.

Permanently delete a library AND every template inside it - irreversible, and there is no per- template delete. Schedule anything you want to keep first.

Permanently delete a calendar note and its comment thread - irreversible. Note ID from tp_list_notes.

Delete a strength workout by ID.

Permanently delete a workout from the calendar - irreversible, applies to planned and completed workouts alike. Workout ID from tp_get_workouts.

Delete a workout file by file_id. Get file_id from tp_get_workout device_files/attachment_files.

Download a workout file by file_id. Get file_id from tp_get_workout device_files/attachment_files.

Get athlete account settings and profile fields (athlete type, linked coach, preferences, units). To change training values use tp_update_ftp / tp_update_hr_zones / tp_update_speed_zones.

Get Annual Training Plan - weekly TSS targets, training periods, races. Max 90 days.

Get availability entries for a date range.

List equipment (bikes, shoes).

List events in a date range.

Get fitness/fatigue trend (CTL/ATL/TSB). Supports historical date ranges.

Get the A-priority focus event with goals and results.

List workout library folders.

Get one workout template in full, including its interval structure - use before tp_schedule_library_workout or when reusing structure. IDs from tp_get_library_items.

List the workout templates in one library (slim listing). library_id from tp_get_libraries. For a template's full interval structure use tp_get_library_item.

Get health metrics for a date range.

Get the nearest future planned event.

Get a calendar note by ID.

Get all comments on a calendar note.

Get nutrition data for a date range.

Get an athlete's top performances for one sport and PR type over a period (days, default 90). Bike pr_type: power1min/5min/20min; Run: speed5K/10K/Half. For PRs from a single workout use tp_get_workout_prs.

Get pool length settings.

Get athlete profile. Rarely needed - other tools work without it.

Get a strength workout's compliance summary (blocks/prescriptions/sets completed).

Get a strength workout's full detail by ID: blocks, exercises, and sets with prescribed vs executed values (Reps, WeightKg, …), plus RPE, feel and compliance. Get IDs from tp_get_strength_workouts.

List structured strength/gym workouts in a date range. Strength workouts live on a separate API and do NOT appear in tp_get_workouts; use this to find them and their IDs, then tp_get_strength_workout for full detail. Returns date, title, duration, compliance, set totals, and an exercise preview.

Summary of one training plan: weeks, per-week duration/distance, sport breakdown, description.

All workouts of a training plan laid out by week/day (sport, title, description, duration, TSS, has_structure).

Combined view of workouts + fitness for a week. Totals TSS, duration, end-of-week CTL/ATL/TSB.

Get workout details by ID. Use after tp_get_workouts.

List the comment thread on a workout (athlete and coach comments with author and timestamp). Workout ID from tp_get_workouts. For the private workout note use tp_get_workout_note.

Get the private workout note for a workout.

List personal records set during one completed workout. Returns an empty list when none. For an athlete's bests across a period use tp_get_peaks.

List workouts in date range. Query only days needed. Max 90 days. Does NOT include strength-builder gym workouts — use tp_get_strength_workouts for those.

List all sport types and subtypes with IDs. Use to find subtype_id for create/update.

List available zone-calculation methods per metric (power / heartrate / speed), each with its zone count and zone labels. TP has no method-names endpoint and settings store only an opaque method int; this probes the zone calculator (read-only) to fingerprint each method by its zone labels. derives_threshold marks methods that derive the threshold from a (field-)test, so a direct threshold can't be set. Coach-scoped (uses your own user), not athlete-specific.

List athletes available to this account (coach accounts).

List the athletes in one athlete group, with names resolved from the coach's roster. Use tp_list_groups to get group_id.

List the coach's athlete groups (TP exposes these as tags). Returns id, name, athlete_count, is_default.

List calendar notes for a date range.

List the coach's authored multi-week training plans (id, title, weeks, workout count, total hours, category, price).

Log health metrics (weight, HRV, sleep, steps, etc.) for a date.

Pair a completed workout with a planned workout. Attaches the completed data to the planned workout, merging them into one.

Refresh auth by extracting cookie from user's browser. Use when other tools return auth errors.

Remove one or more athletes from a group.

Rename an athlete group. The default group cannot be renamed.

Reorder the workouts displayed on a single day. Pass every workout ID for that day (from tp_get_workouts) in the desired order. Changes display order only - dates and content untouched.

Schedule a library template to a calendar date, for yourself or (coach accounts) for one or many athletes.

Search the built-in strength exercise library by name (offline). Returns library exercise IDs to use in tp_create_strength_workout, plus each exercise's native parameters and a demo video URL.

Set or update the private workout note for a workout.

Unpair a workout. Detaches the completed workout file from the planned workout, creating two separate workouts. No data is lost.

Update equipment details.

Update fields on an existing race/event (name, date, priority, distance, description, attached workout legs). Only the provided fields change. Event ID from tp_get_events; events more than ~2 years from today cannot be resolved for update.

Update FTP (power threshold) and rescale the matching power-zone set, preserving its calculation method.

Update heart rate zones.

Edit a workout template.

Update a calendar note. Provide at least one of: title, description, date, is_hidden.

Update daily planned calories.

Update run/swim pace zones.

Update an existing strength workout in place: replace or append blocks, retitle, or mark it complete. Preserves everything else, including Garmin-derived TSS and the attached FIT file — so this is the correct way to fill in a device-synced workout that arrived with no structure. Never delete-and-recreate for that: exercise detail is rebuildable, HR-derived training load is not.

Update fields of an existing workout. Supports the same simplified interval structure format as tp_create_workout plus an optional native structured_workout payload, then fetches existing, merges, and saves.

Upload a workout file (.fit, .tcx, .gpx) to an existing workout.

Validate workout interval structure without creating a workout. Returns block count, duration, estimated IF/TSS.