Get a paginated list of workouts. Returns workout details including title, description, start/end times, and exercises performed. Results are ordered from newest to oldest.

Get complete details of a specific workout by ID. Returns all workout information including title, description, start/end times, and detailed exercise data.

Get the total number of workouts on the account. Useful for pagination or statistics.

Retrieve a paged list of workout events (updates or deletes) since a given date. Events are ordered from newest to oldest. The intention is to allow clients to keep their local cache of workouts up to date without having to fetch the entire list of workouts.

Create a new workout in your Hevy account. Requires title, start/end times, and at least one exercise with sets. Returns the complete workout details upon successful creation including the newly assigned workout ID.

Update an existing workout by ID. You can modify the title, description, start/end times, privacy setting, and exercise data. Returns the updated workout with all changes applied.

Get a paginated list of your workout routines, including custom and default routines. Useful for browsing or searching your available routines.

Get a routine by its ID using the direct endpoint. Returns all details for the specified routine.

Create a new workout routine in your Hevy account. Requires a title and at least one exercise with sets. Optionally assign to a folder. Returns the full routine details including the new routine ID.

Update an existing routine by ID. You can modify the title, notes, and exercise configurations. Returns the updated routine with all changes applied.

Get a paginated list of exercise templates (default and custom) with details like name, category, equipment, and muscle groups. Useful for browsing or searching available exercises.

Get complete details of a specific exercise template by its ID, including name, category, equipment, muscle groups, and notes.

Get past sets for a specific exercise template, optionally filtered by start and end dates.

Create a custom exercise template with title, type, equipment, and muscle groups.

Search exercise templates by name with optional muscle group filter. Fetches all templates from the Hevy API on first call, caches the catalog in memory with a bounded TTL cache, and reuses it for subsequent searches. Use refresh:true to force a re-fetch.

Get a paginated list of your routine folders, including both default and custom folders. Useful for organizing and browsing your workout routines.

Get complete details of a specific routine folder by its ID, including name, creation date, and associated routines.

Create a new routine folder in your Hevy account. Requires a name for the folder. Returns the full folder details including the new folder ID.

Get a paginated list of body measurements for the authenticated user. Returns measurements including weight, body fat, and various circumference measurements.

Get a single body measurement by date. Returns all measurement fields for the specified date.

Create a body measurement entry for a given date. All measurement fields are optional; null values are treated as omitted, since the Hevy API does not support clearing individual fields. Returns 409 if an entry already exists for that date — use update-body-measurement instead.

Update an existing body measurement entry for a given date. Only the fields you provide are sent and updated; null values are treated as omitted, since the Hevy API does not support clearing individual fields. Requires at least one measurement field. Returns 404 if no entry exists for the date.

Get the authenticated user's account info, including user ID, display name, and public profile URL. Useful for verifying which account the API key belongs to.