{"openapi":"3.1.0","info":{"title":"PrintMerch","version":"0.1.0","description":"Custom printed merchandise. The agent drafts a product and mockups; a human reviews and pays with Stripe; only then is the order sent to Printify. Demo mode never contacts Printify.","contact":{"name":"Telep IO","email":"jon@telep.io","url":"https://telep.io"}},"paths":{"/v1/print-merch":{"get":{"tags":["print-merch"],"summary":"Connector descriptor","responses":{"200":{"description":"OK"}}}},"/v1/print-merch/openapi.json":{"get":{"tags":["print-merch"],"summary":"This OpenAPI document","responses":{"200":{"description":"OK"}}}},"/v1/print-merch/products":{"get":{"tags":["print-merch"],"summary":"List print products (read-only catalog)","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing key"}}}},"/v1/print-merch/mockups":{"post":{"tags":["print-merch"],"summary":"Create a mockup for human review. Does not submit an order to production.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["blueprint_id","print_provider_id","variant_id","artwork_url"],"properties":{"blueprint_id":{"type":"integer"},"print_provider_id":{"type":"integer"},"variant_id":{"type":"integer"},"artwork_url":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"401":{"description":"Missing key"}}}},"/v1/print-merch/merch_orders":{"get":{"tags":["print-merch"],"summary":"List merchandise orders for this API key","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing key"}}},"post":{"tags":["print-merch"],"summary":"Create a merchandise draft with mockups and a live quote. Does not send anything to production.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["blueprint_id","print_provider_id","variant_id","artwork_url","quantity","recipient","artwork_rights_attested"],"properties":{"blueprint_id":{"type":"integer"},"print_provider_id":{"type":"integer"},"variant_id":{"type":"integer"},"artwork_url":{"type":"string","description":"https URL of artwork you own or are licensed to print."},"quantity":{"type":"integer","description":"1–50."},"recipient":{"type":"object","additionalProperties":false,"required":["first_name","last_name","email","phone","country","address1","city","zip"],"properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code."},"region":{"type":"string","description":"State or region. Required when country is US."},"address1":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"zip":{"type":"string"}}},"artwork_rights_attested":{"type":"boolean","description":"Must be true. You attest that you own or are licensed for this artwork."}}}}}},"responses":{"201":{"description":"Created"},"401":{"description":"Missing key"}}}},"/v1/print-merch/merch_orders/{id}":{"get":{"tags":["print-merch"],"summary":"Get a merchandise order","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"}}}},"/v1/print-merch/merch_orders/{id}/checkout":{"post":{"tags":["print-merch"],"summary":"Create one Stripe Checkout session for this draft. Does not submit the order to production. A repeat call returns 409.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"}}}},"/v1/print-merch/merch_orders/{id}/cancel":{"post":{"tags":["print-merch"],"summary":"Cancel only while the Printify order is on-hold or payment-not-received.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Authorization: Bearer muse_sk_{demo|test|live}_{token}"}}},"tags":[{"name":"print-merch","description":"Design, quote, and order printed merchandise"}]}