{"info":{"version":"0.1.0","description":"Unique one-of-one codes for clothing. Public records include source_url and updated_at. Owner emails are never returned.","title":"clth.fyi"},"components":{"securitySchemes":{"bearer":{"scheme":"bearer","type":"http"}}},"paths":{"/api/v1/batches":{"get":{"parameters":[],"summary":"List your batches","tags":["maker"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}},"security":[{"bearer":[]}]},"post":{"description":"JSON body: quantity (1-500), optional design_id, sizes, name, made_on. Omit design_id to mint before any garment details exist; pass garment_type (tee, hat, hoodie, other) and an optional design_name, then PATCH /api/v1/designs/{id} later. Each item has label_urls for the qr, facts-blank, and full label styles.","parameters":[],"summary":"Mint a batch","tags":["maker"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}},"security":[{"bearer":[]}]}},"/api/v1/designs":{"get":{"parameters":[],"summary":"List public designs","tags":["designs"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}}}},"/api/v1/designs/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"summary":"Get a design","tags":["designs"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}}},"patch":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"summary":"Add or edit garment details on your design. Scans show the new details right away.","tags":["maker"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}},"security":[{"bearer":[]}]}},"/api/v1/items/{code}":{"get":{"parameters":[{"in":"path","name":"code","required":true,"schema":{"type":"string"}}],"summary":"Get a public item","tags":["items"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}}}},"/api/v1/items/{code}/provenance":{"get":{"parameters":[{"in":"path","name":"code","required":true,"schema":{"type":"string"}}],"summary":"Provenance for an item","tags":["items"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}}}},"/api/v1/orders":{"post":{"parameters":[],"summary":"Allocate a code to an external order","tags":["maker"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}},"security":[{"bearer":[]}]}},"/api/v1/orders/{external_id}":{"get":{"parameters":[{"in":"path","name":"external_id","required":true,"schema":{"type":"string"}}],"summary":"Fetch the code for an order","tags":["maker"],"responses":{"200":{"description":"Record with source_url and updated_at"},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}},"security":[{"bearer":[]}]}},"/label/{code}.svg":{"get":{"parameters":[{"in":"path","name":"code","required":true,"schema":{"type":"string"}},{"in":"query","name":"style","description":"full (default): the full Facts label, public only while the item shows its facts. facts-blank: the Facts frame and QR with no garment details. qr: the QR, short URL, and code.","required":false,"schema":{"default":"full","type":"string","enum":["full","facts-blank","qr"]}}],"summary":"Printable label SVG for one code","tags":["labels"],"responses":{"200":{"description":"SVG","content":{"image/svg+xml":{"schema":{"type":"string"}}}},"400":{"description":"JSON error"},"404":{"description":"JSON error"},"429":{"description":"Rate limited. Retry-After is set."}}}},"/mcp":{"post":{"summary":"Streamable HTTP MCP. Read-only tools: get_item, verify_ownership, get_provenance, list_designs.","responses":{"200":{"description":"JSON-RPC"}}}}},"openapi":"3.0.3","servers":[{"url":"https://clth.fyi"}]}