Get a personal record
get_personal_recordReads- What it does
- Reads only. Changes nothing.
- Permission
- Workouts, read
workouts:read
What your assistant is told
Best performance for one exercise across the user's whole logged history: heaviest set and best estimated 1-rep-max (Epley), counted over working sets only — warm-up and drop sets never set a record, though they do count towards timesPerformed/totalSets. Exercise referenced by exercise. Pass clientHandle to read a coached client's PR.
**Both bests are ranked by loadKg — what the set MOVED — not by weightKg, what was typed in.** They differ wherever loadMode is not "weight": on a pull-up with a belt weightKg is the belt (+20) and loadKg is the body plus the belt; on the same pull-up assisted, weightKg is the assistance as a NEGATIVE (-20) and loadKg is what was left of the body. One exercise spans both, so the bests may be set with a belt and compared against assisted sets on the way up (catalog.md D20). Quote loadKg when you say how much they lifted, and weightKg when you tell them what to set the machine to.
With a bodyweight-based loadMode and bodyweightKg: null the user has never recorded a weigh-in, so the bests are empty even though the sets exist — say that, and don't guess a bodyweight.
Parameters
exercisetext, requiredThe exercise, as a catalogslug(e.g. "barbell-full-squat") or the numericidof one of the user's own.clientHandletext, optionalOptionalclient_handlefromlist_clientsto run this tool against a coached client's data instead of your own. Omit (or pass null) for your own data — the legacy default.