{"openapi":"3.1.0","info":{"title":"Thread API","version":"0.1.0","description":"A fully local sewing/textile reference and calculator toolkit: fabric yardage estimates, seam and hem allowances, needle/thread pairings, clothing size conversion, pattern grading estimates, interfacing and zipper guidance, a sewing glossary, and unit conversion.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://thread.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/thread/docs"},"termsOfService":"https://connectorbay.com/thread/terms"},"servers":[{"url":"https://thread.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/thread/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/fabric_yardage_estimator":{"post":{"operationId":"fabric_yardage_estimator","summary":"A rough fabric yardage estimate for a garment or home-sewing project, adjusted for the fabric's width.","description":"A rough fabric yardage estimate for a garment or home-sewing project, adjusted for the fabric's width.\n    Use for \"how much fabric do I need for a size L shirt\", \"yardage for curtains on a medium window at 54in\n    fabric\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"garment_type":{"description":"dress | shirt | skirt | pants | curtains-per-window | pillow-cover","title":"Garment Type","type":"string"},"size":{"description":"A size for the garment type, e.g. XS-3XL for garments, small/medium/large/extra_large for curtains-per-window, or 14x14-24x24 for pillow-cover.","title":"Size","type":"string"},"fabric_width_in":{"default":45,"description":"Fabric bolt width in inches. Standard widths are 45, 54, and 60in; wider fabric needs less yardage.","exclusiveMinimum":0,"maximum":200,"title":"Fabric Width In","type":"number"}},"required":["garment_type","size"],"title":"fabric_yardage_estimatorArguments","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/seam_allowance_guide":{"post":{"operationId":"seam_allowance_guide","summary":"Standard seam allowance by sewing technique or garment category (quilting ~1/4in, garment sewing ~5/8in,","description":"Standard seam allowance by sewing technique or garment category (quilting ~1/4in, garment sewing ~5/8in,\n    upholstery ~1/2-1in, and more). Use for \"what seam allowance for quilting\", \"seam allowance for upholstery\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"technique":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A sewing technique or garment category, e.g. quilting, garment sewing, french seam, upholstery. Omit to list all.","title":"Technique"}},"title":"seam_allowance_guideArguments","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/needle_thread_guide":{"post":{"operationId":"needle_thread_guide","summary":"Recommended sewing-machine needle size/type and thread weight for a given fabric type. Use for \"what","description":"Recommended sewing-machine needle size/type and thread weight for a given fabric type. Use for \"what\n    needle for denim\", \"what thread for silk chiffon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"fabric_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A fabric type, e.g. denim, silk chiffon, knit / jersey, leather. Omit to list all.","title":"Fabric Type"}},"title":"needle_thread_guideArguments","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/size_conversion":{"post":{"operationId":"size_conversion","summary":"Convert a clothing size across US/UK/EU/India/Japan for women's, men's, or kids' clothing. An approximate,","description":"Convert a clothing size across US/UK/EU/India/Japan for women's, men's, or kids' clothing. An approximate,\n    general-industry mapping — exact sizing varies by brand. Use for \"convert US women's 8 to UK\", \"what's a\n    men's 40 chest in EU sizing\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"size":{"description":"The size to convert, in the from_system.","examples":["8","M","40"],"title":"Size","type":"string"},"from_system":{"description":"us | uk | eu | india | japan (women/men) or us | uk | eu_cm | india | japan_cm (kids)","title":"From System","type":"string"},"to_system":{"description":"The size system to convert into.","title":"To System","type":"string"},"category":{"default":"women","description":"women | men | kids","title":"Category","type":"string"}},"required":["size","from_system","to_system"],"title":"size_conversionArguments","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/hem_allowance_guide":{"post":{"operationId":"hem_allowance_guide","summary":"Standard hem allowance by garment or project type. Use for \"how much hem allowance for a jacket\", \"hem","description":"Standard hem allowance by garment or project type. Use for \"how much hem allowance for a jacket\", \"hem\n    allowance for curtains\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"garment_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A garment or project type, e.g. skirt, jeans, curtains. Omit to list all.","title":"Garment Type"}},"title":"hem_allowance_guideArguments","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/pattern_grading_estimate":{"post":{"operationId":"pattern_grading_estimate","summary":"A rough estimate of how a pattern measurement changes when grading between two sizes, using general","description":"A rough estimate of how a pattern measurement changes when grading between two sizes, using general\n    published grade-rule increments. Exact grading depends on the specific pattern company — this is a general\n    reference. Use for \"estimate the waist at size 14 if it's 30in at size 10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"base_measurement":{"description":"The known measurement (in inches) at base_size, e.g. a 36in bust at size 8.","exclusiveMinimum":0,"title":"Base Measurement","type":"number"},"base_size":{"description":"The size that base_measurement was taken at.","title":"Base Size","type":"number"},"target_size":{"description":"The size to estimate the measurement for.","title":"Target Size","type":"number"},"category":{"default":"women","description":"women | men | kids","title":"Category","type":"string"},"measurement_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"bust/chest, waist, hip, shoulder, sleeve_length, inseam, etc. Omit for the category's default (bust for women, chest for men/kids).","title":"Measurement Type"}},"required":["base_measurement","base_size","target_size"],"title":"pattern_grading_estimateArguments","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/interfacing_guide":{"post":{"operationId":"interfacing_guide","summary":"Recommended interfacing weight/type for a fabric + application combination. Use for \"what interfacing for","description":"Recommended interfacing weight/type for a fabric + application combination. Use for \"what interfacing for\n    a collar on quilting cotton\", \"interfacing for a denim waistband\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"fabric_type":{"description":"A fabric type, e.g. quilting cotton, wool suiting, denim.","title":"Fabric Type","type":"string"},"application":{"description":"collar | cuff | waistband | buttonhole_placket | facing | lapel | bodice_structure | bag_panel","title":"Application","type":"string"}},"required":["fabric_type","application"],"title":"interfacing_guideArguments","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/zipper_length_guide":{"post":{"operationId":"zipper_length_guide","summary":"Typical zipper length and type by garment or project type. Use for \"what size zipper for a hoodie\", \"what","description":"Typical zipper length and type by garment or project type. Use for \"what size zipper for a hoodie\", \"what\n    zipper length for a 16in pillow cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"garment_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A garment or project type, e.g. skirt, dress, jacket, pillow. Omit to list all.","title":"Garment Type"}},"title":"zipper_length_guideArguments","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/sewing_glossary":{"post":{"operationId":"sewing_glossary","summary":"Definitions of common sewing and textile terms (bias, grain, notion, understitching, ease, dart, basting,","description":"Definitions of common sewing and textile terms (bias, grain, notion, understitching, ease, dart, basting,\n    ...). Use for \"what does understitching mean\", \"what's a dart\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific sewing term to look up; omit to list all.","title":"Term"}},"title":"sewing_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}},"/v1/tools/measurement_convert":{"post":{"operationId":"measurement_convert","summary":"Convert a measurement between inches, centimeters, millimeters, yards, and meters. Use for \"convert 3","description":"Convert a measurement between inches, centimeters, millimeters, yards, and meters. Use for \"convert 3\n    yards to meters\", \"convert 5/8 inch to mm\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"value":{"description":"The numeric value to convert.","title":"Value","type":"number"},"from_unit":{"description":"in | cm | mm | yd | m","title":"From Unit","type":"string"},"to_unit":{"description":"in | cm | mm | yd | m","title":"To Unit","type":"string"}},"required":["value","from_unit","to_unit"],"title":"measurement_convertArguments","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}}}}