Run Coach

Create a workout on Garmin Connect from a simple step list, and optionally put it on the calendar (scheduleDate). Use this instead of create-workout. The app shows the new workout's steps. Example: 5x1km intervals on a Tuesday { "name": "5x1km @ 4:00", "sport": "running", "scheduleDate": "2026-10-06", "steps": [ { "type": "warmup", "duration": { "seconds": 900 }, "target": { "hrZone": 2 } }, { "repeat": 5, "steps": [ { "type": "run", "duration": { "meters": 1000 }, "target": { "pace": { "fast": "3:55", "slow": "4:05" } } }, { "type": "recovery", "duration": { "seconds": 90 } } ] }, { "type": "cooldown", "duration": { "seconds": 600 }, "target": { "hrZone": 1 } } ] } An easy run is a single { "type": "run", "duration": { "seconds": 2700 }, "target": { "hrZone": 2 } } step. Base targets on the user's own zones and recent paces (get-training-context).

Create a workout from raw Garmin workout JSON. Prefer create-structured-workout, which builds this JSON from a simple step list and avoids format mistakes; use this only for something it can't express. Workout structure: - sportType: { sportTypeId: 1, sportTypeKey: 'running' } for running - workoutSegments: array of segments, each with segmentOrder and workoutSteps - Each step uses type "ExecutableStepDTO" for regular steps, "RepeatGroupDTO" for repeat groups - Common step structure: { stepOrder, stepType, endCondition, endConditionValue, targetType, targetValueLow, targetValueHigh } Step types: warmup, cooldown, interval, rest, recovery, repeat End conditions: time (seconds), distance (meters), lap.button (manual lap) Target types: heart.rate.zone (1-5), pace.zone, speed.zone, no.target Example - 5x1000m intervals: - Warmup: 15min easy (endCondition: time, endConditionValue: 900) - Repeat group (numberOfIterations: 5): - Interval: 1000m (endCondition: distance, endConditionValue: 1000) - Recovery: 90s jog (endCondition: time, endConditionValue: 90) - Cooldown: 10min easy (endCondition: time, endConditionValue: 600)

Delete a workout from Garmin Connect, with every calendar entry it has. To take one scheduled workout off the calendar and keep the workout, use unschedule-workout.

Check if the user is authenticated with Garmin Connect

Issue a single-use public key for encrypting the Garmin password

One file of the 3D replay's asset pack (scanned materials, sky light, models, running motion; CC0), base64-encoded. Served from a local cache, downloaded once from the app's GitHub release.

Real elevation and OpenStreetMap features (roads, land cover, water, buildings) around an activity's GPS track, for the 3D replay. Only when the real map setting is on.

Time series of an activity for the 3D replay view (GPS, elevation, HR, cadence, speed, power, running dynamics), plus laps, weather and HR zones

Log in to Garmin Connect with email and an encrypted password

Log out of Garmin Connect and clear saved tokens

Read or change whether the run replay fetches real elevation (AWS Terrain Tiles) and map data (OpenStreetMap) for the area around a run

Submit MFA verification code for Garmin Connect login

Get recent activities from Garmin Connect

Activities between two dates, optionally filtered by type (e.g. running, cycling)

Time series (HR, pace, cadence, elevation...) of an activity, downsampled

Get full details for a specific Garmin activity by ID

Strength-training sets, reps and weights of an activity

Gear (e.g. shoes) used for an activity

Get heart rate time-in-zones breakdown for a specific activity

Get splits (pace, HR, cadence) for a specific activity. Returns the laps recorded by the watch (lapDTOs); when the activity was recorded as a single lap (auto-lap off), also per-km splits computed from the time series (kmSplits).

Run/walk/rest splits of an activity

All Garmin activity type keys

Weather during an activity

Get daily body battery charged/drained values for a date range

Events that charged or drained body battery (sleep, activities, stress) for a date

Weight, BMI, body fat and muscle mass for a date

Calendar for a month: scheduled workouts, activities and events

Latest cycling functional threshold power (FTP)

Morning briefing: how the user is today, framed against their own baselines. Use for 'how am I today', 'morning briefing', 'daily check-in', 'should I train today', 'am I recovered'. Returns training readiness (with its limiting factors), last night's sleep (score, duration vs Garmin's optimal, stages), HRV (vs 7-night avg and the balanced range), body battery (vs at wake), resting HR (vs 7-day avg), stress, steps vs goal, training status, the last activity and the past 7 days' volume. Each metric has value, unit, a named baseline, delta and a neutral status (from Garmin's own status fields where it has one); missing metrics carry a reason. After calling it: give a short, warm briefing that leads with the 1–2 numbers that matter most today, then 2–3 concrete, personal suggestions grounded in the numbers (e.g. intensity or duration of today's session, bedtime, recovery), and one thing to watch. Say what you're unsure about (missing metrics, a single bad night vs a trend). Don't restate every number: the app already shows them.

Daily totals: steps, calories, distance, floors, intensity minutes, stress and body battery for a date

Registered Garmin devices

Endurance score for a date, or weekly stats when endDate is given (a single date often has no data)

Fitness age vs chronological age and what drives it

Floors climbed and descended through the day for a date

All gear (shoes, bikes) with usage

Goals by status

Configured heart rate zones per sport

Get heart rate data (resting, min/max, intraday samples) for a day, or for each day from date to endDate in one call. The chart shows the days ending at the last requested date.

Hill score (strength + endurance on climbs) for a date, or weekly stats when endDate is given

Get heart rate variability data (nightly avg, weekly avg, baseline, status) for a date range

Water intake vs goal and sweat loss for a date

Moderate/vigorous intensity minutes for a date and the running weekly total vs goal

The user's latest lactate threshold measurement (heart rate and pace), a physiological metric detected by the watch. Not a saved workout: for workouts named like 'LT' use list-workouts.

Most recently synced device

Personal records (fastest 1K/5K/10K, longest run, etc.)

Device used as the source of training status and metrics

Totals per activity type over a date range for a metric

Get predicted race times for 5K, 10K, half marathon, and marathon

Breathing rate (breaths/min) through the day and during sleep for a date

Daily resting heart rate over a date range