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

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

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

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.

Get workout details by ID. Use after tp_get_workouts.

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.

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.

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

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

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.

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

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

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.

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 the private workout note for a workout.

Set or update the private workout note for a workout.

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

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

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

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

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.

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 workout analysis: metrics, zones, laps. Saves full time-series to JSON file.

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

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

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

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

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).

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.

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.

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

Update heart rate zones.

Update run/swim pace zones.

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.

Update daily planned calories.

Get pool length settings.

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

Get health metrics for a date range.

Get nutrition data for a date range.

List equipment (bikes, shoes).

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.

Update equipment details.

Delete equipment.

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

Get the nearest future planned event.

List events in a date range.

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

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.

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.

Create a calendar note.

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

Get a calendar note by ID.

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

Get all comments on a calendar note.

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.

List calendar notes for a date range.

Get availability entries for a date range.

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.

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

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 workout library folders.

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 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.

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

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

Save a workout template to a library.

Edit a workout template.

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

List athletes available to this account (coach accounts).

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.

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, …).

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

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.

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.

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.

Delete a strength workout by ID.

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

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

Create a new athlete group.

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

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

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

Remove one or more athletes from a group.