Loki Docs
Tools › Exercises › Create a custom exercise

Create a custom exercise

create_custom_exerciseAdds
What it does
Adds a new record and leaves what you had alone.
Permission
Exercises, change exercises:write

What your assistant is told

Mint a user-owned custom exercise for the calling user — the long tail the global catalog can't cover (cable variants, gym-specific machine names, novel movements). Returns the new exercise's numeric id, which is how every other tool refers to it — log_set, get_exercise, a template write. A custom exercise has no slug; only the reviewed catalog does. Use this ONLY when find_exercises has nothing close. Confirm the name and primaryMuscle with the user before calling — the name is what they will see from then on. If the user shows you a photo of a gym machine, extract the fields yourself from the image and call this tool with them. We do NOT accept image data — the photo stays in your conversation with the user, never uploaded to us.

Parameters

  • nametext, requiredHuman-readable name as the user would say it, e.g. "Cable crossover at chest height". Stored as-is and surfaced in the picker; pick a name the user will recognise.
  • primaryMuscletext, requiredSlug of the primary mover muscle (from find_exercises / get_exercise results — they share the muscle vocabulary). e.g. "chest", "lats", "quadriceps". Required.
  • secondaryMuscleslist of object, optionalOptional secondary / synergist muscles, each with an optional loadRatio in (0, 1]. Default loadRatio is 0.5 when omitted. Used by per-muscle insights to weight the contribution.
  • notestext, optionalOptional free text about it — the setup, which machine in the gym, anything the user said. Stored as the user's own note.