Update planned workout
update_planned_workoutChanges a workout that has not been done yet — reschedule it, rename it, or replace its exercise list. Works on an upcoming session and on one the app marked skipped because its time passed; rescheduling a skipped session makes it upcoming again. A finished workout cannot be changed. Pass only the fields you want to change; anything omitted stays as-is. exercises, if given, replaces the whole list — to add an exercise, pass the existing ones plus the new one; to remove one, pass the list without it. Because the list is replaced wholesale, any superset_group labels left out are removed too. A workout can mix strength and conditioning freely: each exercise is measured by its own exercise_type (from search_exercises), so a run, a skipping round or a set of sprints sits in the same list as the lifts — send the targets that type accepts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | New note for the whole session. Send an empty string to clear it; omit to keep the current one. | |
| title | No | New workout name. Omit to keep the current one. | |
| reminder | No | Push reminder for this session, as an offset before it starts — "oneHour" is one hour before, "thisDay" fires at the workout time itself, "none" removes an existing reminder. Omit it to leave the current setting alone. A reminder needs the session to have a time of day. | |
| exercises | No | Replaces the ENTIRE exercise list — send every exercise the workout should keep, not only the changed ones. Omit to keep the current exercises. | |
| workout_id | Yes | From create_planned_workout or list_planned_workouts — never invented. | |
| scheduled_for | No | ISO 8601 date or datetime as local wall-clock time in the user's own timezone, with NO offset — '2026-08-29T21:00:00' for 9pm where the user lives. A trailing 'Z' or numeric offset is accepted and converted, but plain local time is preferred. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| locale | Yes | ||
| web_url | Yes | ||
| warnings | No | ||
| deep_link | Yes | ||
| total_sets | Yes | ||
| workout_id | Yes | ||
| scheduled_for | Yes | ||
| exercise_count | Yes | ||
| display_warnings | No | ||
| estimated_duration_min | Yes |