List workouts in reverse-chronological order. Hevy enforces a max pageSize of 10.

Fetch a single workout by its ID, including all exercises and logged sets.

Get the total number of workouts logged for the authenticated account.

List workout sync events (created/updated/deleted) since a given ISO 8601 timestamp. Useful for incremental sync. Hevy enforces a max pageSize of 10.

Create a new workout. The workout body is strictly validated: title, start_time/end_time (ISO 8601), and at least one exercise with at least one set are required.

Replace an existing workout by ID. The full workout body must be supplied — this is a full replacement, not a patch.

List saved routines (workout templates). Hevy enforces a max pageSize of 10.

Fetch a single routine by its ID, including all planned exercises and sets.

Create a new routine. Routines may optionally live inside a folder via folder_id. Note: the Hevy mobile app does not render rep_range (it uses an undocumented input_modifier field).

Replace an existing routine by ID. Note: the API does NOT accept folder_id on update — folder moves happen via the mobile app only.

List exercise templates (built-in and custom). Hevy enforces a max pageSize of 10. For fuzzy name search prefer search_exercise_templates.

Fetch a single exercise template by its ID.

Fetch per-set history for a single exercise template across all workouts. Optionally bounded by startDate/endDate (ISO 8601). Much cheaper than paginating /v1/workouts when you only care about one exercise.

Create a custom exercise template. Requires title, exercise_type, equipment_category, and muscle_group; other_muscles is optional.

Fuzzy-search exercise templates by name with an optional muscle-group filter. Runs locally against a cached copy of all templates — much faster and cheaper than paginating /v1/exercise_templates. Returns top matches sorted by score.

List routine folders. Hevy enforces a max pageSize of 10.

Fetch a single routine folder by its numeric ID.

Create a new routine folder with the given title. All other fields (id, index, timestamps) are assigned by the server.

Fetch the authenticated user's profile (id, name, public profile URL).

Return a chronological time series of the best set per session for one exercise template. Uses /v1/exercise_history (single API call). Each point includes weight, reps, volume, and Epley-estimated 1RM. Optional since (ISO 8601) defaults to 90 days ago.

Return heaviest-weight, best-set (weight * reps), and top estimated 1RM PRs. If exerciseTemplateId is provided, uses /v1/exercise_history (single call). Otherwise paginates recent workouts and returns a per-exercise map. May include a warning field if paginated results were truncated.

Total training volume (weight_kg * reps, nulls => 0) grouped by exercise, muscle_group, or week. Paginates recent workouts since since (ISO 8601, default 90 days ago). May include a warning field if results were truncated.

Per-week workout counts with streak and longest-gap statistics over since (ISO 8601, default 90 days ago). May include a warning field if results were truncated.

Flag exercises whose peak estimated 1RM occurred earlier in the window (i.e. recent sessions are below peak). Defaults: weeksBack=8, minSessions=3. Returns a list sorted by percent below peak, descending. May include a warning field if truncated.

Duplicate an existing workout. The new workout starts at startTime (defaults to now) and preserves the original's duration, title, exercises, and sets.

Create a new routine from an existing workout. Copies exercises and sets (dropping RPE, which routines do not support) and places the routine in the given folder, if any.

Compare two workouts side-by-side. Returns per-workout summaries, top-level deltas (volume, sets, exercise count), and a per-exercise diff sorted alphabetically by exercise title.