Recent activities from Strava (read-only): id, name, type, start, distance, HR.

Read-only: summarise recent training (from Strava), and size the gap to a marathon goal.

With goal_time ('3:15:00') and race_date ('2027-04-19') also returns what the goal asks for, what a safe ramp reaches, and — when those disagree — the goal this runway does support.

Workouts in the feed (optionally within [start_date, end_date]), each marked with whether HoodaRun has confirmed it's scheduled on the Watch.

What HoodaRun last reported: when it synced, what's on the Watch, what's waiting for a free slot (WorkoutKit caps scheduled workouts), and errors.

Compile a workout or strength spec and return the exact WorkoutKit-shaped JSON HoodaRun would receive, without publishing anything.

Create a structured running workout and schedule it for a date.

schedule_date is 'YYYY-MM-DD'; time is optional 24h 'HH:MM'. The same name on the same date overwrites instead of duplicating. Targets: 'hr:2' (HR zone) or 'pace:6:35-6:55' (min/mi window); durations '15:00', '1mi', '400m', 'open'. Set spec.location='indoor' for treadmill sessions.

Create a guided strength/core workout and schedule it for a date.

Each exercise takes reps (an open set you end with the Action button) or hold ('45s', timed), plus sets and rest_s. Each set shows on the Watch by name, e.g. 'Romanian Deadlift · 8 reps', with a timed rest between sets.

Remove one workout from the feed by id; HoodaRun removes it from the Watch at its next sync.

Remove every feed workout in [start_date, end_date] inclusive.

Destructive. Defaults to dry_run=True — call again with dry_run=False to commit. Only touches workouts this server published; workouts made in HoodaRun's own builder are never removed.

Publish a multi-week plan you wrote yourself.

items is a list of {"date": "YYYY-MM-DD", "spec": } — a spec with exercises is strength, otherwise running. Re-pushing the same plan name updates it in place, and (replace=True) drops sessions from the earlier push that are no longer in the plan. dry_run=True validates and reports without publishing.

Build a marathon block for ANY race and ANY goal, scaled to current fitness.

Reads recent Strava history (unless use_strava_history=False or current_weekly_miles is supplied), compares it to what the goal asks for, and ramps from where the runner actually is — 8%/week ceiling, 3-up-1-down, 3-week taper, ending on race day. If the goal doesn't fit the runway, the plan targets the goal that does and says so; force_goal=True overrides. Two strength sessions a week; weekly fuelling/recovery guidance in the report. dry_run=True validates without publishing.

Build a high-school track block: 800 / 1600 / 3200 / 5k.

goal_time defaults to the barrier — sub-2:00 800, sub-4:30 1600, sub-10:00 3200, sub-15:00 5K. With current_pr the report sizes the gap honestly. training_age ('new' | 'developing' | 'experienced') sets a hard mileage ceiling; Sunday is always rest; no doubles; nutrition guidance is adequacy-only. Take it to the athlete's school coach before running it. dry_run=True validates without publishing.

Marathons in the catalogue whose next running falls inside the window. Dates come from each race's scheduling rule — confirm with the organiser.

Pick a marathon at random from the catalogue — the 'surprise me' path.