{"openapi":"3.1.0","info":{"title":"AIGTEE API","version":"1.0.0","description":"The wearable-identity layer for AI-native commerce: meaning → wearable design → quote → physical commission.","contact":{"name":"AIGTEE API & Partners","url":"https://aigtee.com/developers"}},"servers":[{"url":"https://aigtee.com","description":"Production"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Creation","description":"Turn human meaning into private wearable artwork."},{"name":"Commerce","description":"Price and commission physical garments."}],"paths":{"/api/v1/generate":{"post":{"operationId":"aigteeGenerate","tags":["Creation"],"summary":"Generate wearable design drafts","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sentence"],"additionalProperties":false,"properties":{"sentence":{"type":"string","minLength":1,"maxLength":120,"description":"The human meaning, mood, story, or idea to turn into wearable artwork."},"count":{"type":"integer","minimum":1,"maximum":4,"default":4},"kind":{"type":"string","enum":["image","text"],"default":"image"},"style":{"type":"string","enum":["archive-tee","bootleg-tour","club-system","sticker-chaos","blokecore","indie-sleaze","museum-surreal","workwear-label","quiet-luxury","rave-flyer","minimal","street","cyber","y2k","ukiyo","grunge","deco","guochao","academia","popart","watercolor","tattoo","vaporwave","kawaii","comic"],"default":"minimal"},"palette":{"type":"string","enum":["auto","full","mono","bw","pastel","neon","earth","duotone"],"default":"auto"},"composition":{"type":"string","enum":["centered","oversized","pocket","pattern"],"default":"centered"},"background":{"type":"string","enum":["cutout","scene"],"default":"cutout"},"detail":{"type":"string","enum":["simple","balanced","detailed"],"default":"balanced"}}}}}},"responses":{"200":{"description":"Private design drafts","content":{"application/json":{"schema":{"type":"object","required":["drafts"],"properties":{"drafts":{"type":"array","items":{"type":"object","required":["id","url"],"properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}}}}},"400":{"description":"Invalid generation request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate or daily limit reached","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/quote":{"post":{"operationId":"aigteeQuote","tags":["Commerce"],"summary":"Lock a garment and shipping price for 30 minutes","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["draft_id","garment","size"],"additionalProperties":false,"properties":{"draft_id":{"type":"string","description":"A draft id returned by aigtee_generate."},"garment":{"type":"string","enum":["tee","long","hood"]},"size":{"type":"string","enum":["S","M","L","XL","2XL"]},"country":{"type":"string","minLength":2,"maxLength":2,"default":"US"},"state":{"type":"string","description":"State or province code; improves shipping accuracy."},"zip":{"type":"string","description":"Postal code; improves shipping accuracy."}}}}}},"responses":{"200":{"description":"Locked quote or an unavailable shipping region","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["quote_id","available","total_cents","currency","expires_at"],"properties":{"quote_id":{"type":"string"},"available":{"type":"boolean","const":true},"total_cents":{"type":"integer"},"currency":{"type":"string","example":"usd"},"expires_at":{"type":"string","format":"date-time"},"sandbox":{"type":"boolean"}}},{"type":"object","required":["available","region","message"],"properties":{"available":{"type":"boolean","const":false},"region":{"type":"string"},"message":{"type":"string"}}}]}}}},"400":{"description":"Invalid quote request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Draft not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/commission":{"post":{"operationId":"aigteeCommission","tags":["Commerce"],"summary":"Create a physical commission","description":"Obtain explicit user confirmation for the displayed quote and destination before calling. Live tiers receive a Stripe checkout URL; no automatic charge occurs.","x-aigtee-requires-user-confirmation":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["quote_id","shipping"],"additionalProperties":false,"properties":{"quote_id":{"type":"string","description":"An unexpired, unused quote id."},"email":{"type":"string","format":"email"},"shipping":{"type":"object","additionalProperties":false,"required":["name","line1","city","state","zip","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"country":{"type":"string","minLength":2,"maxLength":2}}}}}}}},"responses":{"200":{"description":"Commission or sandbox simulation created","content":{"application/json":{"schema":{"type":"object","properties":{"commission_id":{"type":"string"},"status":{"type":"string"},"checkout_url":{"type":"string","format":"uri"},"sandbox":{"type":"boolean"}}}}}},"400":{"description":"Invalid commission request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"409":{"description":"Quote expired, used, missing, or owned by another key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate or tier limit reached","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/commissions/{id}":{"get":{"operationId":"aigteeCommissionStatus","tags":["Commerce"],"summary":"Get commission and tracking status","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Commission id, with or without the c_ prefix."}],"responses":{"200":{"description":"Commission status","content":{"application/json":{"schema":{"type":"object","required":["commission_id","status","tracking"],"properties":{"commission_id":{"type":"string"},"status":{"type":"string"},"tracking":{"anyOf":[{"type":"null"},{"type":"object","properties":{"number":{"type":"string"},"url":{"type":"string","format":"uri"},"carrier":{"type":"string"}}}]}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Commission not found or not owned by this key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"AIGTEE API key","description":"Create a sandbox key at /developers/keys. Keys are shown once and stored hashed."}}},"externalDocs":{"description":"Human-readable API reference","url":"https://aigtee.com/api-docs"}}