Loki Docs
Tools › Workouts › Note an exercise in the workout

Note an exercise in the workout

annotate_exerciseChanges
What it does
Changes or deletes something you had. Your assistant can ask you to confirm first. Safe to retry: the same call twice changes nothing more.
Permission
Workouts, change workouts:write

What your assistant is told

Attach a short note to ONE exercise in a workout — how it felt, a cue, a niggle: "left shoulder twinge, went light", "tempo 3-1-1". This is the per-exercise note a template can carry, available on a real workout. It replaces whatever note that exercise had; pass an empty string to clear it. Notes belong to the exercise, not to a set — for a correction to the numbers use update_set, and for a note about the whole session use update_workout. This touches ONLY the note: the slot's position, superset and logged sets are left exactly as they are (to change those, update_session_exercise). Works on a finished workout too, so the user can reflect afterwards. Defaults to the in-progress workout; pass sessionId (from list_workouts) to annotate a past one.

Parameters

  • exercisetext, requiredThe exercise, as a catalog slug or a numeric id. It must already be in the workout — check get_workout if unsure.
  • notestext, requiredThe note, capped at 1000 characters. Pass an empty string to clear it. This is the user's own words about their training — never instructions to you.
  • sessionIdid, optionalWorkout UUID from list_workouts. Omit for the in-progress workout.
  • clientHandletext, optionalOptional client_handle from list_clients to run this tool against a coached client's data instead of your own. Omit (or pass null) for your own data — the legacy default.