Workout Program Generator API

Generate one or multiple workout days in one request

The Program Generator lets you create a single training session or multiple days in one call. This makes it easy to support full splits, weekly plans, or session-by-session generation based on your product workflow.

Configure each session with precision

You can control exactly what the generator should produce:

• Set the level: beginner, intermediate, or advanced.
• Set the goal: hypertrophy, strength, endurance, or weight loss.
• Target muscle groups for each session.
• Set the number of exercises per workout.
• Set an optional session duration target in minutes for each day.
• Define exercises that must be included.
• Define exercises that must be excluded.
• Filter by exercise setup: bodyweight, free weights, machines or cables.
• Filter by movement profile: polyarticular or isolation.

Global fields such as level and goal can be passed at the root of the payload, while day-specific controls such as session duration stay inside each day criteria. If both number of exercises and session duration are provided, number of exercises remains the priority signal for generation. This level of control lets you adapt generation to user goals, equipment context, and coaching logic.

You can also define optional per-exercise training targets directly in the generation input. For any included exercise, set the number of sets, number of reps and weight either as a fixed value or as a minimum / maximum range. This makes it possible to generate programs that include not just the right exercises, but also the intended training volume and load guidance for each movement.

You can also enable automatic prescription generation for a session. When active, the API can enrich returned exercises with generated sets, reps, and rest time, while still keeping any manual exercise prescription as the source of truth when both are provided.

Intelligent generation that stays coherent

The generation engine is designed to return a coherent training structure. It prioritizes more demanding exercises earlier in the session, then places less energy-intensive movements later.

The result is not just a random list, but a program order that feels practical and usable in real training scenarios.

Persist programs with a dedicated endpoint

After generation, you can save the program via a dedicated persistence endpoint. The API returns an identifier so you can retrieve the same program later by ID.

This makes integration much simpler for applications that need:

• program history,
• saved plans,
• user dashboards,
• resuming sessions across devices.

Why this feature matters for product teams

• Ship a robust workout planner without rebuilding program logic from scratch.
• Keep generation quality high while still allowing strict business rules.
• Reduce backend complexity with built-in save/retrieve flows.
• Focus your development effort on UX, retention, and coaching value.

Next step

Start with your key generation constraints, test the output quality in your own UI, then enable persistence to unlock a complete program lifecycle in your app.