{"schema":"tags_v1","service":"The Agents Gift Shop","base_url":"https://tags.srv1466836.hstgr.cloud","protocol":{"name":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","payTo":"0xB0397dB76AAe8E292a6c6fC09F9B484b80158BcF","facilitator":"cdp","payment_header":"PAYMENT-SIGNATURE","challenge_header":"PAYMENT-REQUIRED","receipt_header":"PAYMENT-RESPONSE","enabled":true},"identity":{"model":"No accounts. Paid calls identify you by the paying wallet. Creating a design or an order returns a capability key (design_key / order_key) that authorises the free follow-up calls on that resource. Keys are shown once; store them.","headers":{"X-Design-Key":"design capability key","X-Order-Key":"order capability key"}},"pricing":{"credit_usd":"0.20","design":"$2.00","back_print_extra":"$1.00","premium_extra":"$1.00","regenerate_text":"$0.40","regenerate_photo":"$0.60","regenerate_full":"$1.00","mockup":"$0.60","order":"retail price × quantity + Printify standard shipping, quoted first, charged exactly","retail_cents":{"shirts":2500,"sweaters":4500,"stickers":500,"tote bags":2200,"long sleeve":3500,"mugs":2200,"puzzles":2800,"hats":2500,"phone cases":2000,"blankets":4500},"back_print_retail_extra_cents":500},"flow":["GET /v1/catalog/products — pick a product type","POST /v1/designs (paid) — brief → design_id + design_key (202)","GET /v1/designs/{id} — poll until status=ready (artwork, mockup, lifestyle mockup, title)","optional: POST /v1/designs/{id}/regenerate-* (paid) then POST /v1/designs/{id}/apply","GET /v1/designs/{id}/variants — choose variant_id (size/colour/model)","POST /v1/orders/quote — items + shipping address → order_id + order_key + total","POST /v1/orders/{id}/pay (paid, exactly the quoted total) — order placed with the print provider","GET /v1/orders/{id} — status and tracking"],"endpoints":[{"method":"GET","path":"/","paid":false,"price":"$0.00","summary":"Agent-first landing page"},{"method":"GET","path":"/llms.txt","paid":false,"price":"$0.00","summary":"Plain-text agent guide"},{"method":"GET","path":"/health","paid":false,"price":"$0.00","summary":"Liveness probe","output_example":{"ok":true,"x402":true,"network":"eip155:8453","schema":"tags_v1"}},{"method":"GET","path":"/v1/meta","paid":false,"price":"$0.00","summary":"The machine contract"},{"method":"GET","path":"/openapi.json","paid":false,"price":"$0.00","summary":"OpenAPI 3 document"},{"method":"GET","path":"/v1/catalog/products","paid":false,"price":"$0.00","summary":"Product line with retail prices and options","output_example":{"products":[{"product_type":"shirts","name":"T-Shirt","price_cents":2500,"sizes":["S","M"],"colors":["White"]}],"schema":"tags_v1"}},{"method":"GET","path":"/v1/catalog/designs","paid":false,"price":"$0.00","summary":"Public design gallery","input":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":20},"offset":{"type":"integer","minimum":0,"default":0},"sort":{"type":"string","enum":["newest","popular"],"default":"newest"},"product_type":{"type":"string","enum":["shirts","sweaters","stickers","tote bags","long sleeve","mugs","puzzles","hats","phone cases","blankets"]},"q":{"type":"string","maxLength":80,"description":"substring match on title / niche"}}}},{"method":"GET","path":"/v1/shipping/countries","paid":false,"price":"$0.00","summary":"Supported destination countries","output_example":{"countries":{"US":"United States","CA":"Canada"},"schema":"tags_v1"}},{"method":"GET","path":"/v1/designs/{id}","paid":false,"price":"$0.00","summary":"One design (status, images, title)","path_params":{"id":"design id"},"output_example":{"design_id":"…","status":"ready","step":"done","product_type":"shirts","title":"…","price_cents":2500,"images":{"artwork":"https://…png","mockup":"https://…png","lifestyle":"https://…png"},"orderable":true,"schema":"tags_v1"}},{"method":"GET","path":"/v1/designs/{id}/variants","paid":false,"price":"$0.00","summary":"Orderable variants for a design","path_params":{"id":"design id"},"output_example":{"design_id":"…","product_type":"shirts","variants":[{"variant_id":12345,"size":"M","color":"Black","title":"Black / M"}],"schema":"tags_v1"}},{"method":"POST","path":"/v1/designs","paid":true,"price":"$2.00–$4.00 ($2.00 + $1.00 premium type + $1.00 back print)","summary":"Create a design from a text brief (paid)","settlement":"before the handler runs","price_rule":"$2.00 + $1.00 premium type + $1.00 back print","input":{"type":"object","properties":{"brief":{"type":"string","minLength":3,"maxLength":2000,"description":"What to draw. Put any words you want printed in quotes, e.g. a cat in sunglasses with 'Cool Cat' text"},"product_type":{"type":"string","enum":["shirts","sweaters","stickers","tote bags","long sleeve","mugs","puzzles","hats","phone cases","blankets"],"description":"One of the catalog product types (GET /v1/catalog/products). Premium types add $1.00."},"ai_assisted":{"type":"boolean","default":true,"description":"Let GPT expand the brief into a structured design spec (style, palette, text). false = your words verbatim"},"back_print":{"type":"boolean","default":false,"description":"Apparel only: also generate a back design (+$1.00, retail +$5)"},"is_public":{"type":"boolean","default":false,"description":"List the finished design in the public gallery"}},"required":["brief"],"additionalProperties":false},"output_example":{"design_id":"5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b","design_key":"dk_…(shown once; send as X-Design-Key)","status":"queued","product_type":"shirts","price_cents":2500,"poll":"/v1/designs/5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b","schema":"tags_v1"}},{"method":"POST","path":"/v1/designs/from-image","paid":true,"price":"$2.00–$3.00 ($2.00 + $1.00 premium type)","summary":"Create a design from your image (paid)","settlement":"before the handler runs","price_rule":"$2.00 + $1.00 premium type","input":{"type":"object","properties":{"image_url":{"type":"string","format":"uri","description":"Public https URL of a PNG/JPEG/WEBP (≤10 MB, 100–10000 px)"},"image_base64":{"type":"string","description":"Alternative to image_url: base64 (or data: URI) of the image"},"style":{"type":"string","maxLength":300,"description":"Optional style keywords for the restyle, e.g. 'watercolor, pastel'"},"product_type":{"type":"string","enum":["shirts","sweaters","stickers","tote bags","long sleeve","mugs","puzzles","hats","phone cases","blankets"],"description":"One of the catalog product types (GET /v1/catalog/products). Premium types add $1.00."},"is_public":{"type":"boolean","default":false}},"additionalProperties":false},"output_example":{"design_id":"5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b","design_key":"dk_…(shown once; send as X-Design-Key)","status":"queued","product_type":"shirts","price_cents":2500,"poll":"/v1/designs/5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b","schema":"tags_v1"}},{"method":"POST","path":"/v1/designs/{id}/regenerate-text","paid":true,"price":"$0.40","summary":"New title + description preview (paid)","settlement":"after a successful response","auth":"header X-Design-Key","input":{"type":"object","properties":{},"additionalProperties":false},"path_params":{"id":"design id"},"output_example":{"design_id":"…","preview":{"title":"…","description":"…","artwork":"https://…","mockup":"https://…"},"apply":"POST /v1/designs/{id}/apply","schema":"tags_v1"}},{"method":"POST","path":"/v1/designs/{id}/regenerate-photo","paid":true,"price":"$0.60","summary":"New artwork + mockup preview (paid)","settlement":"before the handler runs","auth":"header X-Design-Key","input":{"type":"object","properties":{"prompt":{"type":"string","maxLength":2000,"description":"Optional new brief; defaults to the original"}},"additionalProperties":false},"path_params":{"id":"design id"},"output_example":{"design_id":"…","preview":{"title":"…","description":"…","artwork":"https://…","mockup":"https://…"},"apply":"POST /v1/designs/{id}/apply","schema":"tags_v1"}},{"method":"POST","path":"/v1/designs/{id}/regenerate-full","paid":true,"price":"$1.00","summary":"New artwork + text + lifestyle photo preview (paid)","settlement":"before the handler runs","auth":"header X-Design-Key","input":{"type":"object","properties":{"prompt":{"type":"string","maxLength":2000,"description":"Optional new brief; defaults to the original"}},"additionalProperties":false},"path_params":{"id":"design id"},"output_example":{"design_id":"…","preview":{"title":"…","description":"…","artwork":"https://…","mockup":"https://…"},"apply":"POST /v1/designs/{id}/apply","schema":"tags_v1"}},{"method":"POST","path":"/v1/designs/{id}/mockup","paid":true,"price":"$0.60","summary":"Lifestyle mockup photo (paid)","settlement":"before the handler runs","auth":"header X-Design-Key","input":{"type":"object","properties":{},"additionalProperties":false},"path_params":{"id":"design id"},"output_example":{"design_id":"…","lifestyle":"https://…png","schema":"tags_v1"}},{"method":"POST","path":"/v1/designs/{id}/apply","paid":false,"price":"$0.00","summary":"Apply the last regeneration preview","auth":"header X-Design-Key","input":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"string","enum":["title","description","artwork","lifestyle"]},"description":"Subset to apply; default all"}},"additionalProperties":false},"path_params":{"id":"design id"}},{"method":"POST","path":"/v1/designs/{id}/retry","paid":false,"price":"$0.00","summary":"Re-run a failed generation (free)","auth":"header X-Design-Key","path_params":{"id":"design id"}},{"method":"PATCH","path":"/v1/designs/{id}","paid":false,"price":"$0.00","summary":"Make a design public or private","auth":"header X-Design-Key","input":{"type":"object","properties":{"is_public":{"type":"boolean"}},"required":["is_public"],"additionalProperties":false},"path_params":{"id":"design id"}},{"method":"DELETE","path":"/v1/designs/{id}","paid":false,"price":"$0.00","summary":"Delete a design","auth":"header X-Design-Key","path_params":{"id":"design id"}},{"method":"POST","path":"/v1/designs/{id}/report","paid":false,"price":"$0.00","summary":"Report a bad image","auth":"header X-Design-Key","input":{"type":"object","properties":{"reason":{"type":"string","maxLength":500}},"additionalProperties":false},"path_params":{"id":"design id"}},{"method":"GET","path":"/v1/me/designs","paid":true,"price":"$0.001","summary":"Designs created by the paying wallet (paid)","settlement":"after a successful response","input":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"offset":{"type":"integer","minimum":0,"default":0}}},"output_example":{"items":[{"design_id":"5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b","design_key":"dk_…(shown once; send as X-Design-Key)","status":"queued","product_type":"shirts","price_cents":2500,"poll":"/v1/designs/5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b","schema":"tags_v1"}],"total":1,"schema":"tags_v1"}},{"method":"POST","path":"/v1/designs/{id}/like","paid":true,"price":"$0.001","summary":"Like / unlike a public design (paid)","settlement":"after a successful response","input":{"type":"object","properties":{},"additionalProperties":false},"path_params":{"id":"design id"},"output_example":{"design_id":"…","liked":true,"likes":3,"schema":"tags_v1"}},{"method":"POST","path":"/v1/orders/quote","paid":false,"price":"$0.00","summary":"Quote an order (free)","input":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"design_id":{"type":"string","format":"uuid"},"variant_id":{"type":"integer","description":"A variant_id from GET /v1/designs/{id}/variants (preferred)"},"size":{"type":"string","enum":["S","M","L","XL","2XL"],"description":"Apparel only, if variant_id is omitted"},"color":{"type":"string","description":"Apparel colour name from the variants list, if variant_id is omitted"},"phone_model":{"type":"string","description":"Phone cases only: a key from /v1/catalog/products options.phone_model"},"pieces":{"type":"string","enum":["96","252","500","1000"],"description":"Puzzles only"},"quantity":{"type":"integer","minimum":1,"maximum":99,"default":1},"design_key":{"type":"string","description":"Required only for your own private designs"}},"required":["design_id"],"additionalProperties":false}},"shipping_address":{"type":"object","description":"Printify-shaped shipping address. Use ISO-3166 alpha-2 country codes and the state/province code for region.","properties":{"first_name":{"type":"string","minLength":1,"maxLength":60},"last_name":{"type":"string","minLength":1,"maxLength":60},"email":{"type":"string","format":"email","description":"Order confirmation + shipping notifications go here"},"phone":{"type":"string","maxLength":32},"address1":{"type":"string","minLength":3,"maxLength":120},"address2":{"type":"string","maxLength":120},"city":{"type":"string","minLength":1,"maxLength":80},"region":{"type":"string","minLength":1,"maxLength":60,"description":"State / province code, e.g. CA"},"zip":{"type":"string","minLength":2,"maxLength":20},"country":{"type":"string","pattern":"^[A-Z]{2}$","enum":["US","CA","GB","AU","DE","FR","IE","NL","ES","IT"]}},"required":["first_name","last_name","email","address1","city","region","zip","country"],"additionalProperties":false}},"required":["items","shipping_address"],"additionalProperties":false},"output_example":{"order_id":"…","order_key":"ok_…(shown once; send as X-Order-Key)","status":"quoted","subtotal_cents":2500,"shipping_cents":499,"total_cents":2999,"total":"$29.99","quote_expires_at":1760600000.0,"pay":"POST /v1/orders/{id}/pay","schema":"tags_v1"}},{"method":"POST","path":"/v1/orders/{id}/pay","paid":true,"price":"$5.00–$5000.00 (subtotal + shipping from the quote)","summary":"Pay a quoted order (paid, exactly the quoted total)","settlement":"before the handler runs","price_rule":"subtotal + shipping from the quote","auth":"header X-Order-Key","input":{"type":"object","properties":{},"additionalProperties":false},"path_params":{"id":"order id from /quote"},"output_example":{"order_id":"…","status":"paid","total_cents":2999,"items":[{"design_id":"…","variant":"Black / M","quantity":1}],"tracking":{"number":"9400…","url":"https://…","carrier":"usps"},"schema":"tags_v1"}},{"method":"GET","path":"/v1/orders/{id}","paid":false,"price":"$0.00","summary":"Order status and tracking","auth":"header X-Order-Key","path_params":{"id":"order id"},"output_example":{"order_id":"…","status":"in_production","total_cents":2999,"items":[{"design_id":"…","variant":"Black / M","quantity":1}],"tracking":{"number":"9400…","url":"https://…","carrier":"usps"},"schema":"tags_v1"}}],"payment_flow":"Unpaid request to a paid path returns HTTP 402 with x402 payment requirements in the PAYMENT-REQUIRED header (base64 JSON). An x402-aware client with a funded wallet pays USDC on Base and retries; the receipt is in PAYMENT-RESPONSE.","refunds":"Payments are final. A failed generation can be re-run free with POST /v1/designs/{id}/retry (up to 2 times). Print defects: email support@theagentsgiftshop.com with the order id and a photo.","contact":"support@theagentsgiftshop.com"}