{"openapi":"3.1.0","info":{"title":"InjuryReturn API","version":"0.1.0","description":"General, non-medical return-to-exercise pacing reference: graduated percentage-based load progression, a red-flag symptom check, pacing principles and a generic phase overview — all local, not medical advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://injuryreturn.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/injuryreturn/docs"},"termsOfService":"https://connectorbay.com/injuryreturn/terms"},"servers":[{"url":"https://injuryreturn.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/injuryreturn/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/graduated_return_plan":{"post":{"operationId":"graduated_return_plan","summary":"A general, percentage-based graduated-return schedule: start at a fraction of your pre-injury weekly","description":"A general, percentage-based graduated-return schedule: start at a fraction of your pre-injury weekly\n    training volume and increase gradually, with a symptom check-in built into every week. NOT a rehab\n    protocol for any specific injury — general pacing philosophy only, and not a substitute for a clinician.\n    Use for \"help me ease back into training after 3 weeks off with a minor issue\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pre_injury_sessions_per_week":{"description":"How many days a week you trained before the injury or break.","maximum":14,"minimum":1,"title":"Pre Injury Sessions Per Week","type":"integer"},"pre_injury_session_minutes":{"description":"Typical session length in minutes before the injury or break.","exclusiveMinimum":0,"maximum":300,"title":"Pre Injury Session Minutes","type":"number"},"weeks_available":{"default":6,"description":"How many weeks you want the ramp-up plan to cover.","maximum":16,"minimum":1,"title":"Weeks Available","type":"integer"},"starting_fraction":{"default":0.5,"description":"Fraction of pre-injury volume to start week 1 at (0.1-0.9). General guidance often starts around a third to half.","maximum":0.9,"minimum":0.1,"title":"Starting Fraction","type":"number"},"weekly_increase_pct":{"default":10.0,"description":"Maximum week-over-week increase, in percent. A conservative, widely cited ceiling is around 10%.","maximum":25,"minimum":2,"title":"Weekly Increase Pct","type":"number"}},"required":["pre_injury_sessions_per_week","pre_injury_session_minutes"],"title":"graduated_return_planArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/red_flag_check":{"post":{"operationId":"red_flag_check","summary":"Checks symptoms against a general list of signs that mean stop the activity and see a clinician","description":"Checks symptoms against a general list of signs that mean stop the activity and see a clinician\n    (worsening pain, swelling, instability, numbness, can't bear weight, night pain, fever/redness, getting\n    worse week over week). Not exhaustive and not a diagnosis. Use for \"is swelling and it's getting worse a\n    reason to stop\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symptoms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Symptoms you're noticing, e.g. ['swelling', 'sharp pain']. Omit to see the full reference list.","title":"Symptoms"}},"title":"red_flag_checkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/pacing_principles":{"post":{"operationId":"pacing_principles","summary":"General, non-medical pacing philosophy by topic: how to think about pain during easing back in, how","description":"General, non-medical pacing philosophy by topic: how to think about pain during easing back in, how\n    much to increase week over week, using cross-training, staying consistent, and warming up. Use for\n    \"general principles for pacing my return to exercise\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"pain_monitoring | load_management | cross_training | consistency | warm_up_and_cooldown. Omit for all.","title":"Topic"}},"title":"pacing_principlesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/phase_overview":{"post":{"operationId":"phase_overview","summary":"A generic six-phase return-to-activity framework (rest -> light aerobic -> general movement ->","description":"A generic six-phase return-to-activity framework (rest -> light aerobic -> general movement ->\n    higher-effort drills -> full training -> full return) with a symptom-based rule for when to advance —\n    deliberately generic, never a protocol for a specific injury. Use for \"what are the general phases of\n    returning to activity after an injury\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"phase_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}