{"openapi":"3.1.0","info":{"title":"Printify Catalog and Shipping Profiles (your token) API","version":"0.1.0","description":"Printify Catalog and Shipping Profiles (your token) lets an AI assistant read your own Printify Catalog data through the Printify Catalog API with a key you supply (personal access token). Read-only: 8 tools (get_blueprint, get_blueprint_size_guide, list_blueprint_print_providers, get_blueprint_print_provider, list_blueprint_variants, get_blueprint_shipping, get_print_provider,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-printify-catalog.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-printify-catalog/docs"},"termsOfService":"https://connectorbay.com/byok-printify-catalog/terms"},"servers":[{"url":"https://byok-printify-catalog.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-printify-catalog/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_blueprint":{"post":{"operationId":"get_blueprint","summary":"Get one blueprint (base product): title, description, brand, model, images, tags, features and care instructions. Use fo","description":"Get one blueprint (base product): title, description, brand, model, images, tags, features and care instructions. Use for \"Tell me about Printify blueprint 3\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blueprint_id":{"description":"Numeric blueprint id (a base product such as a tee) from the Printify blueprints list.","minimum":1,"title":"Blueprint Id","type":"integer"}},"required":["blueprint_id"],"title":"get_blueprintArguments","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/get_blueprint_size_guide":{"post":{"operationId":"get_blueprint_size_guide","summary":"Get the size guide of a blueprint: the available sizes and measurement ranges per size (empty when none is defined). Use","description":"Get the size guide of a blueprint: the available sizes and measurement ranges per size (empty when none is defined). Use for \"What sizes and measurements does Printify blueprint 3 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blueprint_id":{"description":"Numeric blueprint id (a base product such as a tee) from the Printify blueprints list.","minimum":1,"title":"Blueprint Id","type":"integer"}},"required":["blueprint_id"],"title":"get_blueprint_size_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/list_blueprint_print_providers":{"post":{"operationId":"list_blueprint_print_providers","summary":"List the print providers that can produce a blueprint, with decoration methods and average production time in business d","description":"List the print providers that can produce a blueprint, with decoration methods and average production time in business days. Use for \"Which print providers make Printify blueprint 3\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blueprint_id":{"description":"Numeric blueprint id (a base product such as a tee) from the Printify blueprints list.","minimum":1,"title":"Blueprint Id","type":"integer"}},"required":["blueprint_id"],"title":"list_blueprint_print_providersArguments","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/get_blueprint_print_provider":{"post":{"operationId":"get_blueprint_print_provider","summary":"Get one print provider for a blueprint (404 when it does not make that blueprint) with decoration methods and production","description":"Get one print provider for a blueprint (404 when it does not make that blueprint) with decoration methods and production time. Use for \"Does print provider 410 make Printify blueprint 3\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blueprint_id":{"description":"Numeric blueprint id (a base product such as a tee) from the Printify blueprints list.","minimum":1,"title":"Blueprint Id","type":"integer"},"print_provider_id":{"description":"Numeric print provider id from list_blueprint_print_providers.","minimum":1,"title":"Print Provider Id","type":"integer"}},"required":["blueprint_id","print_provider_id"],"title":"get_blueprint_print_providerArguments","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/list_blueprint_variants":{"post":{"operationId":"list_blueprint_variants","summary":"List the variants (colour and size options with print areas) of a blueprint at one print provider; by default only varia","description":"List the variants (colour and size options with print areas) of a blueprint at one print provider; by default only variants in stock. Large for apparel. Use for \"Which colours and sizes does provider 410 offer for Printify blueprint 3\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blueprint_id":{"description":"Numeric blueprint id (a base product such as a tee) from the Printify blueprints list.","minimum":1,"title":"Blueprint Id","type":"integer"},"print_provider_id":{"description":"Numeric print provider id from list_blueprint_print_providers.","minimum":1,"title":"Print Provider Id","type":"integer"},"show_out_of_stock":{"anyOf":[{"maximum":1,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Set 1 to include out-of-stock variants (default 0: only in-stock).","title":"Show Out Of Stock"}},"required":["blueprint_id","print_provider_id"],"title":"list_blueprint_variantsArguments","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/get_blueprint_shipping":{"post":{"operationId":"get_blueprint_shipping","summary":"Get the shipping profiles of a blueprint at one print provider: handling time, first-item and additional-item cost per c","description":"Get the shipping profiles of a blueprint at one print provider: handling time, first-item and additional-item cost per country group (costs in cents). Use for \"What does shipping cost for Printify blueprint 3 from provider 410\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blueprint_id":{"description":"Numeric blueprint id (a base product such as a tee) from the Printify blueprints list.","minimum":1,"title":"Blueprint Id","type":"integer"},"print_provider_id":{"description":"Numeric print provider id from list_blueprint_print_providers.","minimum":1,"title":"Print Provider Id","type":"integer"}},"required":["blueprint_id","print_provider_id"],"title":"get_blueprint_shippingArguments","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/get_print_provider":{"post":{"operationId":"get_print_provider","summary":"Get one print provider with its location (city, region, country; street address included by the API) and the blueprints ","description":"Get one print provider with its location (city, region, country; street address included by the API) and the blueprints it offers. Use for \"Who is Printify print provider 1 and which products do they make\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"print_provider_id":{"description":"Numeric print provider id from list_blueprint_print_providers.","minimum":1,"title":"Print Provider Id","type":"integer"}},"required":["print_provider_id"],"title":"get_print_providerArguments","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/list_shop_webhooks":{"post":{"operationId":"list_shop_webhooks","summary":"List the webhooks registered for a shop with topic, target url and id. Use for \"Which Printify webhooks are set up for s","description":"List the webhooks registered for a shop with topic, target url and id. Use for \"Which Printify webhooks are set up for shop 5432\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"shop_id":{"description":"Numeric id of the Printify shop (from the shops list of the main Printify connector).","maxLength":200,"title":"Shop Id","type":"string"}},"required":["shop_id"],"title":"list_shop_webhooksArguments","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}}}}