Worked examples
Eight calls, real responses
Responses below are captured from the live ontology and trimmed for readability (long lists elided with counts). Every payload keeps its review status, confidence and evidence/safety boundary.
GET
Typo-tolerant search — “bck squat” → Back Squat
EndpointGET /v3/exercise/search?q=bck%20squat
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/search?q=bck%20squat"{
"review_status": "uploaded_base_parent",
"confidence": 0.99,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"query": "bck squat",
"resolved": true,
"results": [
{
"review_status": "uploaded_base_parent",
"confidence": 0.99,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-00018",
"canonical_exercise_name": "Back Squat",
"canonical_key": "back_squat",
"node_type": "BASE",
"movement_family": "general_fitness",
"parent_name": null,
"match_method": "curated_alias",
"matched_term": "Back Squat",
"aliases": [
{
"alias_name": "Back-Squat",
"alias_type": "HYPHEN_APOSTROPHE_VARIANT",
"confidence": 0.9,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
},
{
"alias_name": "BS",
"alias_type": "ABBREVIATION",
"confidence": 0.82,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
}
],
"children": [
{
"exercise_id": "MMSX-CH-00000069",
"canonical_exercise_name": "Assisted Back Squat",
"canonical_key": "assisted_back_squat",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00000072",
"canonical_exercise_name": "Band-Resisted Back Squat",
"canonical_key": "band_resisted_back_squat",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00000071",
"canonical_exercise_name": "Paused Back Squat",
"canonical_key": "paused_back_squat",
"relationship_type": "HAS_ISOMETRIC_VARIATION",
"child_type": "TEMPO_OR_ISOMETRIC_VARIATION_CHILD",
"confidence": 0.93,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00000070",
"canonical_exercise_name": "Tempo Back Squat",
"canonical_key": "tempo_back_squat",
"relationship_type": "HAS_TEMPO_VARIATION",
"child_type": "TEMPO_OR_ISOMETRIC_VARIATION_CHILD",
"confidence": 0.93,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"regressions": [
{
"exercise_id": "MMSX-CH-00000069",
"canonical_exercise_name": "Assisted Back Squat",
"canonical_key": "assisted_back_squat",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"progressions": [],
"equipment_variations": [
{
"exercise_id": "MMSX-CH-00000072",
"canonical_exercise_name": "Band-Resisted Back Squat",
"canonical_key": "band_resisted_back_squat",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"graph_domains": {
"domains": [
"compensation_risk",
"joint_angle",
"phase_timing",
"progression_readiness",
"stability_demand"
],
"summary": {
"compensation_risk": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"joint_angle": {
"increased": 0,
"decreased": 0,
"baseline": 1
},
"phase_timing": {
"increased": 0,
"decreased": 0,
"baseline": 1
},
"progression_readiness": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"stability_demand": {
"increased": 1,
"decreased": 0,
"baseline": 0
}
}
},
"figure_status": "figure_required_for_base_profile"
}
]
}Misspellings resolve through 58,490 search terms. The top result carries a confidence score; treat confidence below the plan threshold as a low_confidence_match and confirm with the user.
GET
Alias — “RDL” → Romanian Deadlift
EndpointGET /v3/exercise/search?q=rdl
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/search?q=rdl"{
"review_status": "uploaded_base_parent",
"confidence": 0.99,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"query": "rdl",
"resolved": true,
"results": [
{
"review_status": "uploaded_base_parent",
"confidence": 0.99,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-00281",
"canonical_exercise_name": "Romanian Deadlift",
"canonical_key": "romanian_deadlift",
"node_type": "BASE",
"movement_family": "general_fitness",
"parent_name": null,
"match_method": "curated_alias",
"matched_term": "Romanian Deadlift",
"aliases": [
{
"alias_name": "Romanian-Deadlift",
"alias_type": "HYPHEN_APOSTROPHE_VARIANT",
"confidence": 0.9,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
},
{
"alias_name": "RD",
"alias_type": "ABBREVIATION",
"confidence": 0.82,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
},
{
"alias_name": "RDL",
"alias_type": "ABBREVIATION",
"confidence": 0.82,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
}
],
"children": [
{
"exercise_id": "MMSX-CH-00001121",
"canonical_exercise_name": "Block Romanian Deadlift",
"canonical_key": "block_romanian_deadlift",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00001124",
"canonical_exercise_name": "Band-Resisted Romanian Deadlift",
"canonical_key": "band_resisted_romanian_deadlift",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00001123",
"canonical_exercise_name": "Paused Romanian Deadlift",
"canonical_key": "paused_romanian_deadlift",
"relationship_type": "HAS_ISOMETRIC_VARIATION",
"child_type": "TEMPO_OR_ISOMETRIC_VARIATION_CHILD",
"confidence": 0.93,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00001122",
"canonical_exercise_name": "Tempo Romanian Deadlift",
"canonical_key": "tempo_romanian_deadlift",
"relationship_type": "HAS_TEMPO_VARIATION",
"child_type": "TEMPO_OR_ISOMETRIC_VARIATION_CHILD",
"confidence": 0.93,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"regressions": [
{
"exercise_id": "MMSX-CH-00001121",
"canonical_exercise_name": "Block Romanian Deadlift",
"canonical_key": "block_romanian_deadlift",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"progressions": [],
"equipment_variations": [
{
"exercise_id": "MMSX-CH-00001124",
"canonical_exercise_name": "Band-Resisted Romanian Deadlift",
"canonical_key": "band_resisted_romanian_deadlift",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"graph_domains": {
"domains": [
"implement_path",
"joint_angle",
"phase_timing",
"stability_demand",
"torque"
],
"summary": {
"implement_path": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"joint_angle": {
"increased": 0,
"decreased": 0,
"baseline": 1
},
"phase_timing": {
"increased": 0,
"decreased": 0,
"baseline": 1
},
"stability_demand": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"torque": {
"increased": 1,
"decreased": 0,
"baseline": 0
}
}
},
"figure_status": "figure_required_for_base_profile"
}
]
}Gym shorthand is first-class: 14,239 alias rows map colloquial names onto canonical ontology nodes.
GET
Alias — “Farmers Walk” → Farmer Carry
EndpointGET /v3/exercise/search?q=farmers%20walk
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/search?q=farmers%20walk"{
"review_status": "uploaded_base_parent",
"confidence": 0.99,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"query": "farmers walk",
"resolved": true,
"results": [
{
"review_status": "uploaded_base_parent",
"confidence": 0.99,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-00100",
"canonical_exercise_name": "Farmer Carry",
"canonical_key": "farmer_carry",
"node_type": "BASE",
"movement_family": "general_fitness",
"parent_name": null,
"match_method": "curated_alias",
"matched_term": "Farmer Carry",
"aliases": [
{
"alias_name": "Farmer's Carry",
"alias_type": "HYPHEN_APOSTROPHE_VARIANT",
"confidence": 0.9,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
},
{
"alias_name": "Farmer-Carry",
"alias_type": "HYPHEN_APOSTROPHE_VARIANT",
"confidence": 0.9,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
},
{
"alias_name": "Farmers Carry",
"alias_type": "SPELLING_VARIANT",
"confidence": 0.9,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
},
{
"alias_name": "FC",
"alias_type": "ABBREVIATION",
"confidence": 0.82,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
}
],
"children": [
{
"exercise_id": "MMSX-CH-00000397",
"canonical_exercise_name": "Light Farmer Carry",
"canonical_key": "light_farmer_carry",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00000399",
"canonical_exercise_name": "Heavy Farmer Carry",
"canonical_key": "heavy_farmer_carry",
"relationship_type": "HAS_PROGRESSION",
"child_type": "PROGRESSION_CHILD",
"confidence": 0.9,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00000400",
"canonical_exercise_name": "Offset Farmer Carry",
"canonical_key": "offset_farmer_carry",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00000398",
"canonical_exercise_name": "Marching Farmer Carry",
"canonical_key": "marching_farmer_carry",
"relationship_type": "HAS_TEMPO_VARIATION",
"child_type": "TEMPO_OR_ISOMETRIC_VARIATION_CHILD",
"confidence": 0.93,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"regressions": [
{
"exercise_id": "MMSX-CH-00000397",
"canonical_exercise_name": "Light Farmer Carry",
"canonical_key": "light_farmer_carry",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"progressions": [
{
"exercise_id": "MMSX-CH-00000399",
"canonical_exercise_name": "Heavy Farmer Carry",
"canonical_key": "heavy_farmer_carry",
"relationship_type": "HAS_PROGRESSION",
"child_type": "PROGRESSION_CHILD",
"confidence": 0.9,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"equipment_variations": [
{
"exercise_id": "MMSX-CH-00000400",
"canonical_exercise_name": "Offset Farmer Carry",
"canonical_key": "offset_farmer_carry",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"graph_domains": {
"domains": [
"fatigue_decay",
"joint_angle",
"load_tolerance",
"phase_timing",
"power_time"
],
"summary": {
"fatigue_decay": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"joint_angle": {
"increased": 0,
"decreased": 0,
"baseline": 1
},
"load_tolerance": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"phase_timing": {
"increased": 0,
"decreased": 0,
"baseline": 1
},
"power_time": {
"increased": 1,
"decreased": 0,
"baseline": 0
}
}
},
"figure_status": "figure_required_for_base_profile"
}
]
}Regional and legacy names resolve to a single canonical record, so downstream analytics never split one movement across labels.
GET
Profile — Back Squat
EndpointGET /v3/exercise/profile?name=Back%20Squat
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/profile?name=Back%20Squat"{
"review_status": "uploaded_base_parent",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-00018",
"canonical_exercise_name": "Back Squat",
"canonical_key": "back_squat",
"node_type": "BASE",
"movement_family": "general_fitness",
"parent_name": null,
"access_tier": null,
"access_tier_note": null,
"children": [
{
"exercise_id": "MMSX-CH-00000072",
"canonical_exercise_name": "Band-Resisted Back Squat",
"canonical_key": "band_resisted_back_squat",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00000071",
"canonical_exercise_name": "Paused Back Squat",
"canonical_key": "paused_back_squat",
"relationship_type": "HAS_ISOMETRIC_VARIATION",
"child_type": "TEMPO_OR_ISOMETRIC_VARIATION_CHILD",
"confidence": 0.93,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00000069",
"canonical_exercise_name": "Assisted Back Squat",
"canonical_key": "assisted_back_squat",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
"… +1 more"
],
"aliases": [
{
"alias_name": "Back-Squat",
"alias_type": "HYPHEN_APOSTROPHE_VARIANT",
"confidence": 0.9,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
},
{
"alias_name": "BS",
"alias_type": "ABBREVIATION",
"confidence": 0.82,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
}
],
"regressions": [
{
"exercise_id": "MMSX-CH-00000069",
"canonical_exercise_name": "Assisted Back Squat",
"canonical_key": "assisted_back_squat",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"progressions": [],
"equipment_variations": [
{
"exercise_id": "MMSX-CH-00000072",
"canonical_exercise_name": "Band-Resisted Back Squat",
"canonical_key": "band_resisted_back_squat",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"context_variations": [],
"graph_domains": {
"domains": [
"compensation_risk",
"fatigue_decay",
"implement_path",
"… +9 more"
],
"summary": {
"compensation_risk": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"joint_angle": {
"increased": 0,
"decreased": 0,
"baseline": 4
},
"phase_timing": {
"increased": 1,
"decreased": 0,
"baseline": 3
},
"progression_readiness": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"stability_demand": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"implement_path": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"torque": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"vector_direction": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"fatigue_decay": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"load_tolerance": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"repetition_quality_decay": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"rom_control": {
"increased": 1,
"decreased": 0,
"baseline": 0
}
},
"rows": [
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "compensation_risk",
"parent_relevance": "baseline",
"child_relevance": "increased",
"delta_reason": "External support reduces balance demand and allows pattern learning.",
"confidence": 0.91
},
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "joint_angle",
"parent_relevance": "baseline",
"child_relevance": "same",
"delta_reason": "Core movement identity remains inherited from parent.",
"confidence": 0.91
},
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "phase_timing",
"parent_relevance": "baseline",
"child_relevance": "same",
"delta_reason": "Core movement identity remains inherited from parent.",
"confidence": 0.91
},
"… +17 more"
]
},
"figure_status": "figure_required_for_base_profile",
"figure_requirement": {
"exercise_id": "MMSX-BE-00018",
"exercise_name": "Back Squat",
"canonical_key": "back_squat",
"parent_name": "",
"node_type": "BASE",
"needs_unique_figure": true,
"can_inherit_parent_figure": false,
"recommended_view": "front-oblique plus side-view if possible",
"pose_phase": "primary execution phase",
"r2_slug": "back_squat",
"review_status": "figure_required_for_base_profile",
"figure_status": "figure_required_for_base_profile",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
"match": {
"query": "Back Squat",
"match_method": "curated_alias",
"matched_term": "Back Squat",
"score": 0.99
}
}One call returns identity, movement family, aliases, variation sets, graph domains and figure status. Free Sandbox receives the basic tier (access_tier: "basic"); Professional and above receive the full record shown here.
GET
Variation tree — Push-Up
EndpointGET /v3/exercise/tree?name=Push-Up
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/tree?name=Push-Up"{
"review_status": "uploaded_base_parent",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-00266",
"canonical_exercise_name": "Push-Up",
"canonical_key": "push_up",
"node_type": "BASE",
"movement_family": "general_fitness",
"parent": null,
"children": [
{
"exercise_id": "MMSX-CH-00001064",
"canonical_exercise_name": "Band-Resisted Push-Up",
"canonical_key": "band_resisted_push_up",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00001063",
"canonical_exercise_name": "Paused Push-Up",
"canonical_key": "paused_push_up",
"relationship_type": "HAS_ISOMETRIC_VARIATION",
"child_type": "TEMPO_OR_ISOMETRIC_VARIATION_CHILD",
"confidence": 0.93,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
{
"exercise_id": "MMSX-CH-00001061",
"canonical_exercise_name": "Assisted Push-Up",
"canonical_key": "assisted_push_up",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
"… +1 more"
],
"aliases": [
{
"alias_name": "Push Up",
"alias_type": "SPELLING_VARIANT",
"confidence": 0.9,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
},
{
"alias_name": "PU",
"alias_type": "ABBREVIATION",
"confidence": 0.82,
"reason": "Generated from punctuation, abbreviation or common naming variation.",
"review_status": "machine_generated_needs_mmsx_review"
}
],
"regressions": [
{
"exercise_id": "MMSX-CH-00001061",
"canonical_exercise_name": "Assisted Push-Up",
"canonical_key": "assisted_push_up",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"progressions": [],
"equipment_variations": [
{
"exercise_id": "MMSX-CH-00001064",
"canonical_exercise_name": "Band-Resisted Push-Up",
"canonical_key": "band_resisted_push_up",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
],
"context_variations": [],
"graph_delta_summary": {
"domains": [
"compensation_risk",
"fatigue_decay",
"implement_path",
"joint_angle",
"load_tolerance",
"phase_timing",
"progression_readiness",
"repetition_quality_decay",
"rom_control",
"stability_demand",
"torque",
"vector_direction"
],
"summary": {
"compensation_risk": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"joint_angle": {
"increased": 0,
"decreased": 0,
"baseline": 4
},
"phase_timing": {
"increased": 2,
"decreased": 0,
"baseline": 4
},
"progression_readiness": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"stability_demand": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"implement_path": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"torque": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"vector_direction": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"fatigue_decay": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"load_tolerance": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"repetition_quality_decay": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"rom_control": {
"increased": 2,
"decreased": 0,
"baseline": 0
}
}
},
"figure_requirement": {
"exercise_id": "MMSX-BE-00266",
"exercise_name": "Push-Up",
"canonical_key": "push_up",
"parent_name": "",
"node_type": "BASE",
"needs_unique_figure": true,
"can_inherit_parent_figure": false,
"recommended_view": "front-oblique plus side-view if possible",
"pose_phase": "primary execution phase",
"r2_slug": "push_up",
"review_status": "figure_required_for_base_profile",
"figure_status": "figure_required_for_base_profile",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
},
"figure_status": "figure_required_for_base_profile",
"match": {
"query": "Push-Up",
"match_method": "curated_alias",
"matched_term": "Push-Up",
"score": 0.99
}
}Trees expose the 28,000-edge parent–child structure: regressions, progressions, equipment variations and context variations.
GET
Children — Plank
EndpointGET /v3/exercise/children?name=Plank
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/children?name=Plank"{
"review_status": "uploaded_base_parent",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-00247",
"canonical_exercise_name": "Plank",
"canonical_key": "plank",
"node_type": "BASE",
"movement_family": "general_fitness",
"parent_name": null,
"children": [
{
"edge_id": "MMSX-EDGE-00000988",
"exercise_id": "MMSX-CH-00000988",
"canonical_exercise_name": "Loaded Plank",
"canonical_key": "loaded_plank",
"relationship_type": "HAS_EQUIPMENT_VARIATION",
"child_type": "EQUIPMENT_VARIATION_CHILD",
"mechanical_delta": {
"parent_pattern": "Plank",
"family_class": "core_plank",
"change_summary": "External load increases bracing, compensation-risk and endurance demand.",
"load_or_complexity_change": "equipment/context altered",
"expected_coaching_focus": "Maintain parent movement intent while monitoring compensation risk, phase timing and quality decay."
},
"graph_domain_delta": {
"increased_relevance": [
"vector_direction",
"torque",
"stability_demand",
"implement_path",
"rom_control",
"clinical_risk_modifier",
"return_to_training_readiness"
],
"decreased_relevance": [],
"same_as_parent": [
"joint_angle",
"phase_timing"
],
"notes": "Graph-domain priority changes are modelled for decision-support and require measured data for lab claims."
},
"figure_requirement": {
"needs_unique_figure": true,
"can_inherit_parent_figure": false,
"recommended_view": "same parent view plus variation-specific equipment/context if applicable",
"pose_phase": "primary altered phase",
"r2_slug": "loaded_plank"
},
"confidence": 0.89,
"review_status": "machine_generated_needs_mmsx_review",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated."
},
{
"edge_id": "MMSX-EDGE-00000986",
"exercise_id": "MMSX-CH-00000986",
"canonical_exercise_name": "Long-Lever Plank",
"canonical_key": "long_lever_plank",
"relationship_type": "HAS_PROGRESSION",
"child_type": "PROGRESSION_CHILD",
"mechanical_delta": {
"parent_pattern": "Plank",
"family_class": "core_plank",
"change_summary": "Longer lever increases anti-extension and tissue-stress demand.",
"load_or_complexity_change": "increased",
"expected_coaching_focus": "Maintain parent movement intent while monitoring compensation risk, phase timing and quality decay."
},
"graph_domain_delta": {
"increased_relevance": [
"load_tolerance",
"power_time",
"fatigue_decay",
"progression_readiness",
"rom_control",
"clinical_risk_modifier",
"return_to_training_readiness"
],
"decreased_relevance": [],
"same_as_parent": [
"joint_angle",
"phase_timing"
],
"notes": "Graph-domain priority changes are modelled for decision-support and require measured data for lab claims."
},
"figure_requirement": {
"needs_unique_figure": true,
"can_inherit_parent_figure": false,
"recommended_view": "same parent view plus variation-specific equipment/context if applicable",
"pose_phase": "primary altered phase",
"r2_slug": "long_lever_plank"
},
"confidence": 0.9,
"review_status": "machine_generated_needs_mmsx_review",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated."
},
{
"edge_id": "MMSX-EDGE-00000985",
"exercise_id": "MMSX-CH-00000985",
"canonical_exercise_name": "Supported Plank",
"canonical_key": "supported_plank",
"relationship_type": "HAS_REGRESSION",
"child_type": "REGRESSION_CHILD",
"mechanical_delta": {
"parent_pattern": "Plank",
"family_class": "core_plank",
"change_summary": "Support shortens lever or reduces load for safer trunk-control entry.",
"load_or_complexity_change": "reduced",
"expected_coaching_focus": "Maintain parent movement intent while monitoring compensation risk, phase timing and quality decay."
},
"graph_domain_delta": {
"increased_relevance": [
"stability_demand",
"compensation_risk",
"progression_readiness",
"rom_control",
"clinical_risk_modifier",
"return_to_training_readiness"
],
"decreased_relevance": [
"load_tolerance",
"tissue_stress"
],
"same_as_parent": [
"joint_angle",
"phase_timing"
],
"notes": "Graph-domain priority changes are modelled for decision-support and require measured data for lab claims."
},
"figure_requirement": {
"needs_unique_figure": false,
"can_inherit_parent_figure": true,
"recommended_view": "same parent view plus variation-specific equipment/context if applicable",
"pose_phase": "primary altered phase",
"r2_slug": "supported_plank"
},
"confidence": 0.91,
"review_status": "machine_generated_needs_mmsx_review",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated."
},
"… +1 more"
]
}Children returns direct variations only — lighter than a full tree when building pickers or progression menus.
GET
Graph domains — Back Squat
EndpointGET /v3/exercise/graph-domains?name=Back%20Squat
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/graph-domains?name=Back%20Squat"{
"review_status": "uploaded_base_parent",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-00018",
"canonical_exercise_name": "Back Squat",
"canonical_key": "back_squat",
"node_type": "BASE",
"movement_family": "general_fitness",
"parent_name": null,
"access_tier": null,
"access_tier_note": null,
"graph_domains": {
"domains": [
"compensation_risk",
"fatigue_decay",
"implement_path",
"… +9 more"
],
"summary": {
"compensation_risk": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"joint_angle": {
"increased": 0,
"decreased": 0,
"baseline": 4
},
"phase_timing": {
"increased": 2,
"decreased": 0,
"baseline": 4
},
"progression_readiness": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"stability_demand": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"implement_path": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"torque": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"vector_direction": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"fatigue_decay": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"load_tolerance": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"repetition_quality_decay": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"rom_control": {
"increased": 2,
"decreased": 0,
"baseline": 0
}
},
"rows": [
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "compensation_risk",
"parent_relevance": "baseline",
"child_relevance": "increased",
"delta_reason": "External support reduces balance demand and allows pattern learning.",
"confidence": 0.91
},
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "joint_angle",
"parent_relevance": "baseline",
"child_relevance": "same",
"delta_reason": "Core movement identity remains inherited from parent.",
"confidence": 0.91
},
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "phase_timing",
"parent_relevance": "baseline",
"child_relevance": "same",
"delta_reason": "Core movement identity remains inherited from parent.",
"confidence": 0.91
},
"… +22 more"
]
}
}Graph domains are modelled decision-support biomechanics interpretations, not laboratory measurements — see the evidence boundary. Developer plan receives the basic tier (top domains, no interpretation summary).
GET
Figures — Technical Stand-Up
EndpointGET /v3/exercise/figures?name=Technical%20Stand-Up
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/figures?name=Technical%20Stand-Up"{
"review_status": "uploaded_base_parent",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-01502",
"canonical_exercise_name": "Technical Stand-Up",
"canonical_key": "technical_stand_up",
"node_type": "BASE",
"movement_family": "grappling_movement",
"parent_name": null,
"access_tier": null,
"access_tier_note": null,
"figure_status": "figure_required_for_base_profile",
"figure_requirement": {
"exercise_id": "MMSX-BE-01502",
"exercise_name": "Technical Stand-Up",
"canonical_key": "technical_stand_up",
"parent_name": "",
"node_type": "BASE",
"needs_unique_figure": true,
"can_inherit_parent_figure": false,
"recommended_view": "front-oblique plus side-view if possible",
"pose_phase": "primary execution phase",
"r2_slug": "technical_stand_up",
"review_status": "figure_required_for_base_profile",
"figure_status": "figure_required_for_base_profile",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
}Figure requirements drive the future reference-card and illustration pipeline; status tells you whether figure assets are required and prepared for a node.