{"openapi":"3.1.0","info":{"title":"Squarespace Site, Store Pages and Discounts (your key) API","version":"0.1.0","description":"Squarespace Site, Store Pages and Discounts (your key) lets an AI assistant read your own Squarespace Store Config data through the Squarespace Store Config API with a key you supply (Commerce API key with read-only Discounts and Products permission (needs the Commerce Advanced plan)). Read-only: 5 tools (get_website, list_store_pages, list_discounts, get_discount, list_fulfillment_options). The...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-squarespace-store-config.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-squarespace-store-config/docs"},"termsOfService":"https://connectorbay.com/byok-squarespace-store-config/terms"},"servers":[{"url":"https://byok-squarespace-store-config.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-squarespace-store-config/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_website":{"post":{"operationId":"get_website","summary":"Get the basic profile of the Squarespace site that owns the key: title, URL, currency, language, time zone, measurement ","description":"Get the basic profile of the Squarespace site that owns the key: title, URL, currency, language, time zone, measurement standard and country/region. Use for \"What currency and time zone is my Squarespace store set to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_websiteArguments","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_store_pages":{"post":{"operationId":"list_store_pages","summary":"List the site's store pages with title, URL slug and whether each is enabled. Pages with a cursor. Use for \"Which store ","description":"List the site's store pages with title, URL slug and whether each is enabled. Pages with a cursor. Use for \"Which store pages does my Squarespace site have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page: pagination.nextPageCursor from the previous answer. Leave out for the first page.","title":"Cursor"}},"title":"list_store_pagesArguments","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_discounts":{"post":{"operationId":"list_discounts","summary":"List the store's discount rules (name, status, trigger code or automatic, template type, limits, number of uses and vali","description":"List the store's discount rules (name, status, trigger code or automatic, template type, limits, number of uses and validity dates); promo codes themselves are not requested. Use for \"Which discounts are active in my Squarespace store\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"status":{"anyOf":[{"enum":["ALL","ACTIVE","EXPIRED","SCHEDULED"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter by lifecycle status.","title":"Status"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search across discount name and promo code.","title":"Search"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Page size (1 to 1000).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Zero-based offset into the result set.","title":"Offset"}},"title":"list_discountsArguments","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_discount":{"post":{"operationId":"get_discount","summary":"Get one discount rule by id. Use for \"Show Squarespace discount 6a1b2c3d4e5f6a7b8c9d0e1f\".","description":"Get one discount rule by id. Use for \"Show Squarespace discount 6a1b2c3d4e5f6a7b8c9d0e1f\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"discount_id":{"description":"Discount id from list_discounts.","maxLength":64,"title":"Discount Id","type":"string"}},"required":["discount_id"],"title":"get_discountArguments","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_fulfillment_options":{"post":{"operationId":"list_fulfillment_options","summary":"List the fulfillment options (shipping, pickup and so on) set up on the site with their ids and the carrier services eac","description":"List the fulfillment options (shipping, pickup and so on) set up on the site with their ids and the carrier services each can use. Use for \"Which shipping options does my Squarespace store offer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_fulfillment_optionsArguments","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}}}}