{"openapi":"3.1.0","info":{"title":"Sellbrite (BYOK) API","version":"0.1.0","description":"Sellbrite (BYOK) lets an AI assistant read your own Sellbrite data through the Sellbrite API with a key you supply (account token (API token)). Read-only: 8 tools (list_channels, list_warehouses, list_orders, get_order, list_inventory, list_products, get_product, list_variation_groups). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached;...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sellbrite.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sellbrite/docs"},"termsOfService":"https://connectorbay.com/byok-sellbrite/terms"},"servers":[{"url":"https://byok-sellbrite.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sellbrite/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/list_channels":{"post":{"operationId":"list_channels","summary":"List the sales channels connected to Sellbrite (Amazon, eBay, Etsy and others) with state and region. Use for \"Which sal","description":"List the sales channels connected to Sellbrite (Amazon, eBay, Etsy and others) with state and region. Use for \"Which sales channels are connected to my Sellbrite account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_channelsArguments","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_warehouses":{"post":{"operationId":"list_warehouses","summary":"List warehouses with name, type (Sellbrite or Amazon FBA), city, region, country and archived flag. Use for \"Which wareh","description":"List warehouses with name, type (Sellbrite or Amazon FBA), city, region, country and archived flag. Use for \"Which warehouses do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_warehousesArguments","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_orders":{"post":{"operationId":"list_orders","summary":"List orders across all channels with order number, channel, statuses, totals, dates, requested shipping and line items. ","description":"List orders across all channels with order number, channel, statuses, totals, dates, requested shipping and line items. Buyer names, emails, phones and addresses are left out. Up to 100 per page; filter by date or status. Use for \"Which orders are still open and unshipped\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"status":{"anyOf":[{"enum":["open","completed","canceled"],"type":"string"},{"type":"null"}],"default":null,"description":"Order status: open, completed or canceled.","title":"Status"},"payment_status":{"anyOf":[{"enum":["all","partial","none"],"type":"string"},{"type":"null"}],"default":null,"description":"Payment status: all, partial or none.","title":"Payment Status"},"shipment_status":{"anyOf":[{"enum":["all","partial","none"],"type":"string"},{"type":"null"}],"default":null,"description":"Shipment status: all, partial or none.","title":"Shipment Status"},"ordered_after":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only orders placed after this ISO 8601 date and time.","title":"Ordered After"},"ordered_before":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only orders placed before this ISO 8601 date and time.","title":"Ordered Before"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (default 100, maximum 100).","title":"Limit"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_ordersArguments","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_order":{"post":{"operationId":"get_order","summary":"One order by its Sellbrite sequence number, with statuses, totals, dates and line items (buyer details are left out). Us","description":"One order by its Sellbrite sequence number, with statuses, totals, dates and line items (buyer details are left out). Use for \"Show Sellbrite order 1001\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sb_order_seq":{"description":"Sellbrite order sequence number (sb_order_seq from list_orders).","maxLength":200,"title":"Sb Order Seq","type":"string"}},"required":["sb_order_seq"],"title":"get_orderArguments","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_inventory":{"post":{"operationId":"list_inventory","summary":"List inventory per SKU and warehouse: on hand, available, reserved, product name, package size and weight, cost, barcode","description":"List inventory per SKU and warehouse: on hand, available, reserved, product name, package size and weight, cost, barcodes and bin location. Filter by warehouse, SKU or dates. Use for \"Which SKUs are low on stock in warehouse w1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"warehouse_uuid":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this warehouse (uuid from list_warehouses).","title":"Warehouse Uuid"},"sku":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only this SKU.","title":"Sku"},"updated_after":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only inventory updated on or after this date (YYYY-MM-DD).","title":"Updated After"},"updated_before":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only inventory updated on or before this date (YYYY-MM-DD).","title":"Updated Before"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (default 100, maximum 100).","title":"Limit"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_inventoryArguments","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_products":{"post":{"operationId":"list_products","summary":"List products in the Sellbrite catalog (sku, name, description, price and related fields as returned by Sellbrite). Filt","description":"List products in the Sellbrite catalog (sku, name, description, price and related fields as returned by Sellbrite). Filter by modification date. Use for \"Which products changed in the last week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"modified_after":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only products modified after this ISO 8601 date and time.","title":"Modified After"},"modified_before":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only products modified before this ISO 8601 date and time.","title":"Modified Before"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (default 100, maximum 100).","title":"Limit"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_productsArguments","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_product":{"post":{"operationId":"get_product","summary":"One product by SKU: name, description, price and, for variation groups, the child variations. Use for \"Show product TS-1","description":"One product by SKU: name, description, price and, for variation groups, the child variations. Use for \"Show product TS-1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sku":{"description":"Product SKU.","maxLength":100,"title":"Sku","type":"string"}},"required":["sku"],"title":"get_productArguments","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_variation_groups":{"post":{"operationId":"list_variation_groups","summary":"List variation groups (parent products with their child variations) in the catalog. Use for \"Which products have size or","description":"List variation groups (parent products with their child variations) in the catalog. Use for \"Which products have size or color variations\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (default 100, maximum 100).","title":"Limit"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_variation_groupsArguments","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}}}}