{"openapi":"3.1.0","info":{"title":"Rackbeat (BYOK) API","version":"0.1.0","description":"Rackbeat (BYOK) lets an AI assistant read your own Rackbeat data through the Rackbeat API with a key you supply (Rackbeat API key (Company settings > API)). Read-only: 10 tools (list_products, list_product_locations, list_product_groups, list_locations, list_suppliers, list_purchase_orders, list_orders, list_purchase_receipts, list_production_orders, list_order_shipments). The BYOK key travels...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-rackbeat.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-rackbeat/docs"},"termsOfService":"https://connectorbay.com/byok-rackbeat/terms"},"servers":[{"url":"https://byok-rackbeat.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-rackbeat/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_products":{"post":{"operationId":"list_products","summary":"List products with number, name, barcode, price, cost price, stock, quantities on order and available, minimum stock, gr","description":"List products with number, name, barcode, price, cost price, stock, quantities on order and available, minimum stock, group, unit and default supplier. Use for \"Which Rackbeat products are below minimum stock\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"number":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only the product with this product number.","title":"Number"},"barcode":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only the product with this barcode.","title":"Barcode"},"is_sellable":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on sellable products: true or false.","title":"Is Sellable"},"is_barred":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on blocked products: true or false.","title":"Is Barred"},"updated_at_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated from this time, such as 2026-09-01 00:00:00.","title":"Updated At From"},"updated_at_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated up to this time, such as 2026-09-30 23:59:59.","title":"Updated At To"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"},"fields":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"number,name,barcode,type,sales_price,cost_price,stock_quantity,in_order_quantity,available_quantity,min_stock,is_barred,group(name),unit(name),default_supplier(name),updated_at","description":"Fields to return (comma-separated, sub-fields in parentheses). Leave the default unless you need others.","title":"Fields"}},"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/list_product_locations":{"post":{"operationId":"list_product_locations","summary":"List the stock of one product at each location: stock, on order, available and purchased quantities. Use for \"Where is p","description":"List the stock of one product at each location: stock, on order, available and purchased quantities. Use for \"Where is product 1001 stored in Rackbeat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_number":{"description":"Product number.","maxLength":200,"title":"Product Number","type":"string"}},"required":["product_number"],"title":"list_product_locationsArguments","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_product_groups":{"post":{"operationId":"list_product_groups","summary":"List product groups with product counts and whether they hold inventory. Use for \"What product groups does Rackbeat have","description":"List product groups with product counts and whether they hold inventory. Use for \"What product groups does Rackbeat have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"updated_at_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated from this time, such as 2026-09-01 00:00:00.","title":"Updated At From"},"updated_at_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated up to this time, such as 2026-09-30 23:59:59.","title":"Updated At To"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"}},"title":"list_product_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}},"/v1/tools/list_locations":{"post":{"operationId":"list_locations","summary":"List stock locations with barcode, nesting and parent. Use for \"Which warehouse locations are set up in Rackbeat\".","description":"List stock locations with barcode, nesting and parent. Use for \"Which warehouse locations are set up in Rackbeat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"barcode":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only the location with this barcode.","title":"Barcode"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"}},"title":"list_locationsArguments","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_suppliers":{"post":{"operationId":"list_suppliers","summary":"List suppliers with name, company, city, country, currency and average delivery time. Contact details are left out. Use ","description":"List suppliers with name, company, city, country, currency and average delivery time. Contact details are left out. Use for \"Who are my Rackbeat suppliers\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"company_name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only suppliers with this company name.","title":"Company Name"},"updated_at_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated from this time, such as 2026-09-01 00:00:00.","title":"Updated At From"},"updated_at_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated up to this time, such as 2026-09-30 23:59:59.","title":"Updated At To"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"}},"title":"list_suppliersArguments","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_purchase_orders":{"post":{"operationId":"list_purchase_orders","summary":"List purchase orders with supplier, totals, currency, booked, approved and received flags and delivery dates. Use for \"W","description":"List purchase orders with supplier, totals, currency, booked, approved and received flags and delivery dates. Use for \"Which Rackbeat purchase orders are not received yet\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"supplier_number":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only this supplier number.","title":"Supplier Number"},"is_received":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on fully received orders: true or false.","title":"Is Received"},"is_booked":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on booked orders: true or false.","title":"Is Booked"},"is_approved":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on approved orders: true or false.","title":"Is Approved"},"purchase_date_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Purchase date from, such as 2026-09-01 00:00:00.","title":"Purchase Date From"},"purchase_date_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Purchase date up to, such as 2026-09-30 23:59:59.","title":"Purchase Date To"},"updated_at_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated from this time, such as 2026-09-01 00:00:00.","title":"Updated At From"},"updated_at_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated up to this time, such as 2026-09-30 23:59:59.","title":"Updated At To"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"},"fields":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"number,supplier(name),total_total,currency,is_booked,is_approved,is_received,is_partly_received,is_cancelled,purchase_date,preferred_delivery_date,received_at,updated_at","description":"Fields to return (comma-separated, sub-fields in parentheses). Leave the default unless you need others.","title":"Fields"}},"title":"list_purchase_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/list_orders":{"post":{"operationId":"list_orders","summary":"List sales orders with totals, profit, currency, status flags (booked, shipped, invoiced) and dates. Customer details ar","description":"List sales orders with totals, profit, currency, status flags (booked, shipped, invoiced) and dates. Customer details are left out. Use for \"Which Rackbeat sales orders are ready for shipping\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"is_booked":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on booked orders: true or false.","title":"Is Booked"},"is_shipped":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on shipped orders: true or false.","title":"Is Shipped"},"is_ready_for_shipping":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on orders ready for shipping: true or false.","title":"Is Ready For Shipping"},"is_cancelled":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on cancelled orders: true or false.","title":"Is Cancelled"},"order_date_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Order date from, such as 2026-09-01 00:00:00.","title":"Order Date From"},"order_date_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Order date up to, such as 2026-09-30 23:59:59.","title":"Order Date To"},"updated_at_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated from this time, such as 2026-09-01 00:00:00.","title":"Updated At From"},"updated_at_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated up to this time, such as 2026-09-30 23:59:59.","title":"Updated At To"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"},"fields":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"number,total_total,total_profit,currency,is_booked,is_cancelled,is_shipped,is_partly_shipped,is_invoiced,order_date,deliver_at,delivered_at,updated_at","description":"Fields to return (comma-separated, sub-fields in parentheses). Leave the default unless you need others.","title":"Fields"}},"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/list_purchase_receipts":{"post":{"operationId":"list_purchase_receipts","summary":"List goods receipts with received flag and dates. Use for \"What goods receipts are open in Rackbeat\".","description":"List goods receipts with received flag and dates. Use for \"What goods receipts are open in Rackbeat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"is_received":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on received receipts: true or false.","title":"Is Received"},"purchase_order_number":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only receipts for this purchase order number.","title":"Purchase Order Number"},"updated_at_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated from this time, such as 2026-09-01 00:00:00.","title":"Updated At From"},"updated_at_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated up to this time, such as 2026-09-30 23:59:59.","title":"Updated At To"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"},"fields":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"number,is_received,received_at,preferred_delivery_date,created_at,updated_at","description":"Fields to return (comma-separated, sub-fields in parentheses). Leave the default unless you need others.","title":"Fields"}},"title":"list_purchase_receiptsArguments","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_production_orders":{"post":{"operationId":"list_production_orders","summary":"List production orders with state flags and start, expected finish and finish dates. Use for \"Which Rackbeat production ","description":"List production orders with state flags and start, expected finish and finish dates. Use for \"Which Rackbeat production orders are running\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"is_started":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on started production orders: true or false.","title":"Is Started"},"is_finished":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on finished production orders: true or false.","title":"Is Finished"},"is_cancelled":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on cancelled production orders: true or false.","title":"Is Cancelled"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"},"fields":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"number,is_started,is_finished,is_cancelled,start_date,expected_finished_at,finished_at,created_at,updated_at","description":"Fields to return (comma-separated, sub-fields in parentheses). Leave the default unless you need others.","title":"Fields"}},"title":"list_production_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/list_order_shipments":{"post":{"operationId":"list_order_shipments","summary":"List shipments with picked and shipped flags and dates. Customer details are left out. Use for \"Which Rackbeat shipments","description":"List shipments with picked and shipped flags and dates. Customer details are left out. Use for \"Which Rackbeat shipments are picked but not shipped\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free text to search for.","title":"Search"},"is_picked":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on picked shipments: true or false.","title":"Is Picked"},"is_shipped":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter on shipped shipments: true or false.","title":"Is Shipped"},"order_number":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only shipments of this order number.","title":"Order Number"},"updated_at_from":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated from this time, such as 2026-09-01 00:00:00.","title":"Updated At From"},"updated_at_to":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records updated up to this time, such as 2026-09-30 23:59:59.","title":"Updated At To"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records per page (default 20).","title":"Limit"},"fields":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"id,is_picked,is_partly_picked,is_shipped,shipping_date,shipped_at,picked_at,created_at,updated_at","description":"Fields to return (comma-separated, sub-fields in parentheses). Leave the default unless you need others.","title":"Fields"}},"title":"list_order_shipmentsArguments","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}}}}