{"openapi":"3.1.0","info":{"title":"Postpartum API","version":"0.1.0","description":"Postpartum recovery-timeline, seek-care and self-care educational reference: non-diagnostic, general-consensus content plus date arithmetic to place a person on the timeline.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://postpartum.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/postpartum/docs"},"termsOfService":"https://connectorbay.com/postpartum/terms"},"servers":[{"url":"https://postpartum.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/postpartum/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/recovery_timeline":{"post":{"operationId":"recovery_timeline","summary":"General postpartum physical-recovery timeline (bleeding/uterus, healing, energy and mood, activity,","description":"General postpartum physical-recovery timeline (bleeding/uterus, healing, energy and mood, activity,\n    typical provider contact) for a point in the first year, plus what's typical next. Non-diagnostic general\n    education — every recovery is individual. Use for \"what's normal at 2 weeks postpartum\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"delivery_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date of birth/delivery, YYYY-MM-DD (or give days_postpartum / weeks_postpartum instead).","title":"Delivery Date"},"on":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date to report for (default today); only used with delivery_date.","title":"On"},"days_postpartum":{"anyOf":[{"maximum":400,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Days since delivery, instead of a date.","title":"Days Postpartum"},"weeks_postpartum":{"anyOf":[{"maximum":57,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Weeks since delivery, instead of a date.","title":"Weeks Postpartum"}},"title":"recovery_timelineArguments","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/seek_care_guidance":{"post":{"operationId":"seek_care_guidance","summary":"When to seek care after birth: emergency warning signs, same-day-call signs, general perinatal mood-","description":"When to seek care after birth: emergency warning signs, same-day-call signs, general perinatal mood-\n    disorder awareness (definitions only, never an assessment), and real support resources. Use for \"when\n    should I worry about bleeding after birth\", \"difference between baby blues and postpartum depression\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symptom":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A symptom or word to check, e.g. bleeding, fever, headache, mood.","title":"Symptom"}},"title":"seek_care_guidanceArguments","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/self_care_guidance":{"post":{"operationId":"self_care_guidance","summary":"General postpartum self-care and rest guidance (rest, nutrition, perineal/incision care, pelvic floor,","description":"General postpartum self-care and rest guidance (rest, nutrition, perineal/incision care, pelvic floor,\n    returning to exercise, emotional support, professional check-ins). Use for \"self-care tips for the first\n    weeks after birth\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"days_postpartum":{"anyOf":[{"maximum":400,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Days since delivery, to narrow the guidance to what's most relevant now (omit for the full general list).","title":"Days Postpartum"}},"title":"self_care_guidanceArguments","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/postpartum_glossary":{"post":{"operationId":"postpartum_glossary","summary":"Definitions of postpartum terms used elsewhere in this connector. Use for \"what is lochia\", \"what's the","description":"Definitions of postpartum terms used elsewhere in this connector. Use for \"what is lochia\", \"what's the\n    fourth trimester\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up (e.g. lochia, involution, baby blues); omit to list all.","title":"Term"}},"title":"postpartum_glossaryArguments","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}}}}