{"openapi":"3.0.3","info":{"title":"Stark TMS Open API","version":"1.0.0","description":"Send outbound orders and inbound shipments to the warehouse; read stock, tracking and your products; receive signed callbacks. Documentation: /open-api/"},"servers":[{"url":"/open-api/v1"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"tags":[{"name":"Account"},{"name":"Orders"},{"name":"Stock"},{"name":"Inbounds"},{"name":"Products"},{"name":"Callbacks"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Authorization: Bearer stk_…"},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code.","enum":["UNAUTHENTICATED","INVALID_API_KEY","API_KEY_REVOKED","CLIENT_INACTIVE","INSUFFICIENT_SCOPE","RATE_LIMITED","INVALID_JSON","PAYLOAD_TOO_LARGE","VALIDATION_FAILED","NOT_FOUND","ORDER_NOT_FOUND","INBOUND_NOT_FOUND","PRODUCT_NOT_FOUND","DELIVERY_NOT_FOUND","SKU_NOT_FOUND","WAREHOUSE_NOT_FOUND","CALLBACK_URL_REJECTED","FEATURE_NOT_AVAILABLE","ORDER_EXISTS","ORDER_IN_PROGRESS","ORDER_NOT_CANCELLABLE","INBOUND_EXISTS","INBOUND_IN_PROGRESS","INBOUND_NOT_CANCELLABLE","PRODUCT_EXISTS","SKU_TAKEN","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_IN_PROGRESS","WEBHOOK_NOT_CONFIGURED","INTERNAL_ERROR"]},"message":{"type":"string","description":"What went wrong and what to change, in English."},"messageZh":{"type":"string","description":"中文说明"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"The field, e.g. items[0].sku"},"message":{"type":"string","description":"What is wrong with it."}}},"description":"Present for VALIDATION_FAILED and some others: every problem at once."}},"required":["code","message","messageZh"]},"ErrorResponse":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"type":"string","description":""}},"required":["ok","error"]},"Address":{"type":"object","properties":{"name":{"type":"string","description":"Recipient.","maxLength":100},"company":{"type":"string","description":"","maxLength":100},"street1":{"type":"string","description":"","maxLength":200},"street2":{"type":"string","description":"","maxLength":200},"city":{"type":"string","description":"","maxLength":100},"state":{"type":"string","description":"Two-letter code in the US and Canada.","maxLength":60},"postalCode":{"type":"string","description":"","maxLength":20},"country":{"type":"string","description":"ISO 3166-1 alpha-2. Default US.","minLength":2,"maxLength":2},"phone":{"type":"string","description":"","maxLength":40},"email":{"type":"string","description":"","maxLength":200},"residential":{"type":"boolean","nullable":true,"description":"Omit if unknown."}},"required":["name","street1","city","postalCode"]},"OrderLine":{"type":"object","properties":{"sku":{"type":"string","description":"One of your products (POST /products).","maxLength":80},"quantity":{"type":"integer","description":"","minimum":1,"maximum":100000},"unitPrice":{"type":"number","description":"Price paid per unit, for customs and records.","minimum":0},"name":{"type":"string","description":"Shown on the packing slip; defaults to the product name.","maxLength":200}},"required":["sku","quantity"]},"Weight":{"type":"object","properties":{"value":{"type":"number","description":"","exclusiveMinimum":true,"minimum":0},"unit":{"type":"string","description":"","enum":["oz","lb","g","kg"]}},"required":["value","unit"]},"Dimensions":{"type":"object","properties":{"length":{"type":"number","description":""},"width":{"type":"number","description":""},"height":{"type":"number","description":""},"unit":{"type":"string","description":"","enum":["in","cm"]}},"required":["length","width","height","unit"]},"OrderInput":{"type":"object","properties":{"orderNo":{"type":"string","description":"Your order number: unique per account, and the order’s identity — sending it again returns the same order.","maxLength":60},"orderDate":{"type":"string","description":"When the buyer ordered, ISO 8601.","format":"date-time"},"warehouseCode":{"type":"string","description":"Which warehouse ships it (GET /warehouses). Optional."},"shipTo":{"$ref":"#/components/schemas/Address"},"items":{"type":"array","items":{"$ref":"#/components/schemas/OrderLine"},"description":"1 to 200 lines."},"shippingService":{"type":"string","description":"The service the buyer chose, as text (shown to the warehouse).","maxLength":100},"weight":{"$ref":"#/components/schemas/Weight"},"dimensions":{"$ref":"#/components/schemas/Dimensions"},"notes":{"type":"string","description":"Buyer’s note.","maxLength":1000},"references":{"type":"object","properties":{"po":{"type":"string","description":""},"ref1":{"type":"string","description":""},"ref2":{"type":"string","description":""}},"description":"Your own references, kept with the order."},"storeName":{"type":"string","description":"Shown as the store in the warehouse’s order list. Default “Open API · <your code>”.","maxLength":80},"callbackUrl":{"type":"string","description":"https address that also receives this order’s callbacks.","maxLength":512}},"required":["orderNo","shipTo","items"]},"Package":{"type":"object","properties":{"packageId":{"type":"integer","description":""},"status":{"type":"string","description":"","enum":["awaiting_label","label_created","cancelled"]},"trackingNumber":{"type":"string","description":"","nullable":true},"carrier":{"type":"string","description":"FedEx, UPS, USPS or DHL.","nullable":true},"service":{"type":"string","description":"Carrier service code.","nullable":true},"trackingUrl":{"type":"string","description":"","nullable":true},"labelCreatedAt":{"type":"string","description":"","format":"date-time","nullable":true},"weight":{"$ref":"#/components/schemas/Weight","nullable":true},"dimensions":{"$ref":"#/components/schemas/Dimensions","nullable":true}}},"Order":{"type":"object","properties":{"orderNo":{"type":"string","description":"Your order number."},"warehouseOrderNo":{"type":"string","description":"The warehouse’s own number for it (MW number)."},"status":{"type":"string","description":"awaiting_shipment → shipped (every package has its label and tracking); or on_hold, cancelled.","enum":["awaiting_shipment","on_hold","shipped","cancelled"]},"hold":{"type":"object","properties":{"reason":{"type":"string","description":""}},"description":"Set while on hold."},"orderDate":{"type":"string","description":""},"warehouseCode":{"type":"string","description":"","nullable":true},"shippingService":{"type":"string","description":"","nullable":true},"shipTo":{"$ref":"#/components/schemas/Address"},"items":{"type":"array","items":{"$ref":"#/components/schemas/OrderLine"}},"notes":{"type":"string","description":""},"references":{"type":"object","properties":{"po":{"type":"string","description":""},"ref1":{"type":"string","description":""},"ref2":{"type":"string","description":""}}},"trackingNumbers":{"type":"array","items":{"type":"string","description":""},"description":"Every label’s tracking number, once bought."},"packages":{"type":"array","items":{"$ref":"#/components/schemas/Package"}},"shippedAt":{"type":"string","description":"When the last label was bought.","format":"date-time","nullable":true},"callbackUrl":{"type":"string","description":"","nullable":true},"createdAt":{"type":"string","description":"","format":"date-time"},"updatedAt":{"type":"string","description":"","format":"date-time"}}},"OrderCreated":{"type":"object","properties":{"created":{"type":"boolean","description":"false when this order number already existed with the same content: nothing new was made."},"order":{"$ref":"#/components/schemas/Order"}}},"BatchResult":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position in your request."},"id":{"type":"string","description":"orderNo or sku as sent."},"ok":{"type":"boolean"},"created":{"type":"boolean"},"order":{"$ref":"#/components/schemas/Order"},"product":{"$ref":"#/components/schemas/Product"},"error":{"$ref":"#/components/schemas/Error"}}}},"succeeded":{"type":"integer","description":""},"failed":{"type":"integer","description":""}}},"WarehouseStock":{"type":"object","properties":{"warehouseCode":{"type":"string","description":""},"onHand":{"type":"integer","description":"Units on the shelves."},"available":{"type":"integer","description":"onHand minus damaged."},"damaged":{"type":"integer","description":"Units set aside as damaged."},"inbound":{"type":"integer","description":"Units still expected on open inbounds."}}},"Stock":{"type":"object","properties":{"sku":{"type":"string","description":""},"name":{"type":"string","description":""},"onHand":{"type":"integer","description":""},"available":{"type":"integer","description":""},"damaged":{"type":"integer","description":""},"inbound":{"type":"integer","description":""},"warehouses":{"type":"array","items":{"$ref":"#/components/schemas/WarehouseStock"}},"warehouseCode":{"type":"string","description":"Set when filtered by warehouse.","nullable":true},"bundle":{"type":"object","properties":{"components":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":""},"quantity":{"type":"integer","description":"Units of this product in one bundle."}}}}},"description":"Only on a bundle (kit). A bundle holds no stock of its own: onHand and available are how many whole bundles its components make, warehouse by warehouse."}}},"Warehouse":{"type":"object","properties":{"code":{"type":"string","description":""},"name":{"type":"string","description":""},"address":{"type":"object","properties":{"street1":{"type":"string","description":""},"city":{"type":"string","description":""},"state":{"type":"string","description":""},"postalCode":{"type":"string","description":""},"country":{"type":"string","description":""}}}}},"InboundInput":{"type":"object","properties":{"reference":{"type":"string","description":"Your ASN / PO number: unique per account, and the inbound’s identity.","maxLength":80},"warehouseCode":{"type":"string","description":"Where it is going (GET /warehouses)."},"type":{"type":"string","description":"","enum":["container","pallet","parcel","other"]},"containerSize":{"type":"string","description":"Containers only.","enum":["20GP","40GP","40HQ","45HQ"]},"expectedDate":{"type":"string","description":"YYYY-MM-DD","format":"date"},"notes":{"type":"string","description":"","maxLength":2000},"lines":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"One of your products."},"quantity":{"type":"integer","description":"","minimum":1}},"required":["sku","quantity"]},"description":"1 to 2000 lines; a SKU listed twice is added up."},"callbackUrl":{"type":"string","description":"https address that also receives this inbound’s callbacks."}},"required":["reference","warehouseCode","lines"]},"Inbound":{"type":"object","properties":{"reference":{"type":"string","description":""},"warehouseInboundNo":{"type":"string","description":"The warehouse’s number (IN<date>-NN)."},"status":{"type":"string","description":"","enum":["awaiting","receiving","received","cancelled"]},"warehouseCode":{"type":"string","description":""},"type":{"type":"string","description":""},"containerSize":{"type":"string","description":"","nullable":true},"expectedDate":{"type":"string","description":"","nullable":true},"notes":{"type":"string","description":""},"lines":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":""},"name":{"type":"string","description":""},"expected":{"type":"integer","description":""},"received":{"type":"integer","description":""},"unexpected":{"type":"boolean","description":"Arrived but was not on the list."}}}},"totals":{"type":"object","properties":{"expected":{"type":"integer","description":""},"received":{"type":"integer","description":""}}},"callbackUrl":{"type":"string","description":"","nullable":true},"createdAt":{"type":"string","description":""},"receivedAt":{"type":"string","description":"","nullable":true}}},"InboundCreated":{"type":"object","properties":{"created":{"type":"boolean"},"inbound":{"$ref":"#/components/schemas/Inbound"}}},"ProductInput":{"type":"object","properties":{"sku":{"type":"string","description":"","maxLength":80},"name":{"type":"string","description":"","maxLength":200},"upc":{"type":"string","description":"8–14 digits."},"fnsku":{"type":"string","description":""},"asin":{"type":"string","description":""},"weight":{"$ref":"#/components/schemas/Weight"},"dimensions":{"$ref":"#/components/schemas/Dimensions"}},"required":["sku","name"]},"Product":{"type":"object","properties":{"sku":{"type":"string","description":""},"name":{"type":"string","description":""},"upc":{"type":"string","description":""},"fnsku":{"type":"string","description":""},"asin":{"type":"string","description":""},"weight":{"$ref":"#/components/schemas/Weight","nullable":true},"dimensions":{"$ref":"#/components/schemas/Dimensions","nullable":true},"active":{"type":"boolean"},"createdAt":{"type":"string","description":""},"updatedAt":{"type":"string","description":""}}},"ProductCreated":{"type":"object","properties":{"created":{"type":"boolean"},"product":{"$ref":"#/components/schemas/Product"}}},"Webhook":{"type":"object","properties":{"url":{"type":"string","description":"","nullable":true},"events":{"type":"array","items":{"type":"string","description":"","enum":["order.shipped","order.tracking_updated","order.cancelled","inbound.received"]}},"signingSecretLastFour":{"type":"string","description":"","nullable":true},"updatedAt":{"type":"string","description":""}}},"Delivery":{"type":"object","properties":{"id":{"type":"integer","description":""},"eventId":{"type":"string","description":""},"event":{"type":"string","description":""},"url":{"type":"string","description":""},"host":{"type":"string","description":""},"status":{"type":"string","description":"","enum":["pending","sending","delivered","failed"]},"attempts":{"type":"integer","description":""},"lastStatus":{"type":"integer","description":"","nullable":true},"lastError":{"type":"string","description":"","nullable":true},"nextAttemptAt":{"type":"string","description":"","nullable":true},"createdAt":{"type":"string","description":""},"deliveredAt":{"type":"string","description":"","nullable":true}}},"Event":{"type":"object","properties":{"id":{"type":"string","description":"evt_…, the same on every retry."},"type":{"type":"string","description":"","enum":["order.shipped","order.tracking_updated","order.cancelled","inbound.received","ping"]},"apiVersion":{"type":"string","description":""},"createdAt":{"type":"string","description":""},"client":{"type":"object","properties":{"code":{"type":"string","description":""}}},"data":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/Order"},"inbound":{"$ref":"#/components/schemas/Inbound"}},"description":"order for order.*, inbound for inbound.*"}},"description":"The body POSTed to your callback address. Verify X-Stark-Signature before trusting it."}}},"x-scopes":["orders:read","orders:write","stock:read","inbound:read","inbound:write","products:read","products:write","webhook:read","webhook:write"],"paths":{"/me":{"get":{"tags":["Account"],"summary":"Who this key belongs to, its permissions and rate limit","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"client":{"type":"object","properties":{"code":{"type":"string","description":""},"name":{"type":"string","description":""}}},"key":{"type":"object","properties":{"id":{"type":"integer","description":""},"scopes":{"type":"array","items":{"type":"string","description":""}},"rateLimitPerMinute":{"type":"integer","description":""}}},"apiVersion":{"type":"string","description":""}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/warehouses":{"get":{"tags":["Account"],"summary":"The warehouses an order or inbound can name","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Warehouse"}}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/orders":{"post":{"tags":["Orders"],"summary":"Create an outbound order","x-scope":"orders:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Any unique string up to 200 characters. Retrying with the same key and body returns the first answer (with Idempotent-Replayed: true) instead of acting twice; kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderInput"},"example":{"orderNo":"SO-10001","orderDate":"2026-10-07T15:30:00Z","warehouseCode":"CA1","shipTo":{"name":"Jane Buyer","street1":"100 Main St","street2":"Apt 4","city":"Austin","state":"TX","postalCode":"78701","country":"US","phone":"5125550100","email":"jane@example.com"},"items":[{"sku":"ANZO-123","quantity":2,"unitPrice":19.99}],"shippingService":"Standard","references":{"po":"PO-7781"},"callbackUrl":"https://erp.example.com/stark/callback"}}}},"responses":{"200":{"description":"Already existed with the same content (created: false)","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/OrderCreated"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/OrderCreated"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"ORDER_EXISTS, ORDER_IN_PROGRESS, IDEMPOTENCY_KEY_REUSED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"SKU_NOT_FOUND, WAREHOUSE_NOT_FOUND, CALLBACK_URL_REJECTED, FEATURE_NOT_AVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Orders"],"summary":"List your orders, most recently changed first","x-scope":"orders:read","parameters":[{"name":"status","in":"query","required":false,"description":"Only orders in this status.","schema":{"type":"string","enum":["awaiting_shipment","on_hold","shipped","cancelled"]}},{"name":"orderNos","in":"query","required":false,"description":"Comma-separated order numbers (up to 100).","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"Only orders changed at or after this time (ISO 8601).","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer","minimum":1}},{"name":"pageSize","in":"query","required":false,"description":"Entries per page.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"page":{"type":"integer","description":"Page number, from 1."},"pageSize":{"type":"integer","description":"Entries per page."},"total":{"type":"integer","description":"Entries matching, across all pages."},"hasMore":{"type":"boolean"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/orders/batch":{"post":{"tags":["Orders"],"summary":"Create up to 50 orders; each succeeds or fails on its own","x-scope":"orders:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Any unique string up to 200 characters. Retrying with the same key and body returns the first answer (with Idempotent-Replayed: true) instead of acting twice; kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/OrderInput"}},{"type":"object","properties":{"orders":{"type":"array","items":{"$ref":"#/components/schemas/OrderInput"}}},"required":["orders"]}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/BatchResult"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/orders/{orderNo}":{"get":{"tags":["Orders"],"summary":"One order, with its packages and tracking","x-scope":"orders:read","parameters":[{"name":"orderNo","in":"path","required":true,"description":"Your order number. URL-encode it.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/Order"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"ORDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/orders/{orderNo}/cancel":{"post":{"tags":["Orders"],"summary":"Cancel an order the warehouse has not bought a label for","x-scope":"orders:write","parameters":[{"name":"orderNo","in":"path","required":true,"description":"Your order number. URL-encode it.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/Order"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"ORDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"ORDER_NOT_CANCELLABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/stock":{"get":{"tags":["Stock"],"summary":"Stock of your products, by SKU and by warehouse","x-scope":"stock:read","parameters":[{"name":"skus","in":"query","required":false,"description":"Comma-separated SKUs (up to 200). Without it, every active product.","schema":{"type":"string"}},{"name":"warehouseCode","in":"query","required":false,"description":"Only this warehouse.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer","minimum":1}},{"name":"pageSize","in":"query","required":false,"description":"Entries per page.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Stock"}},"page":{"type":"integer","description":"Page number, from 1."},"pageSize":{"type":"integer","description":"Entries per page."},"total":{"type":"integer","description":"Entries matching, across all pages."},"hasMore":{"type":"boolean"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"WAREHOUSE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/stock/{sku}":{"get":{"tags":["Stock"],"summary":"Stock of one product","x-scope":"stock:read","parameters":[{"name":"sku","in":"path","required":true,"description":"Your SKU. URL-encode it.","schema":{"type":"string"}},{"name":"warehouseCode","in":"query","required":false,"description":"Only this warehouse.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/Stock"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"PRODUCT_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"WAREHOUSE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/inbounds":{"post":{"tags":["Inbounds"],"summary":"Tell the warehouse a shipment is coming (lands in Receiving)","x-scope":"inbound:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Any unique string up to 200 characters. Retrying with the same key and body returns the first answer (with Idempotent-Replayed: true) instead of acting twice; kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundInput"},"example":{"reference":"ASN-2026-001","warehouseCode":"CA1","type":"container","containerSize":"40HQ","expectedDate":"2026-10-20","lines":[{"sku":"ANZO-123","quantity":500}]}}}},"responses":{"200":{"description":"Already existed with the same content (created: false)","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/InboundCreated"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/InboundCreated"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"INBOUND_EXISTS, INBOUND_IN_PROGRESS, IDEMPOTENCY_KEY_REUSED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"SKU_NOT_FOUND, WAREHOUSE_NOT_FOUND, CALLBACK_URL_REJECTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Inbounds"],"summary":"List your inbounds, newest first","x-scope":"inbound:read","parameters":[{"name":"status","in":"query","required":false,"description":"","schema":{"type":"string","enum":["awaiting","receiving","received","cancelled"]}},{"name":"references","in":"query","required":false,"description":"Comma-separated references.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer","minimum":1}},{"name":"pageSize","in":"query","required":false,"description":"Entries per page.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Inbound"}},"page":{"type":"integer","description":"Page number, from 1."},"pageSize":{"type":"integer","description":"Entries per page."},"total":{"type":"integer","description":"Entries matching, across all pages."},"hasMore":{"type":"boolean"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/inbounds/{reference}":{"get":{"tags":["Inbounds"],"summary":"One inbound, with what has been received","x-scope":"inbound:read","parameters":[{"name":"reference","in":"path","required":true,"description":"Your reference. URL-encode it.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/Inbound"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"INBOUND_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/inbounds/{reference}/cancel":{"post":{"tags":["Inbounds"],"summary":"Cancel an inbound nothing has been received against","x-scope":"inbound:write","parameters":[{"name":"reference","in":"path","required":true,"description":"Your reference. URL-encode it.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"inbound":{"$ref":"#/components/schemas/Inbound"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"INBOUND_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"INBOUND_NOT_CANCELLABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/products":{"post":{"tags":["Products"],"summary":"Create a product","x-scope":"products:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Any unique string up to 200 characters. Retrying with the same key and body returns the first answer (with Idempotent-Replayed: true) instead of acting twice; kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductInput"},"example":{"sku":"ANZO-123","name":"Tail light, left","upc":"012345678905","weight":{"value":2.5,"unit":"lb"},"dimensions":{"length":12,"width":8,"height":6,"unit":"in"}}}}},"responses":{"200":{"description":"Already existed with the same details (created: false)","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/ProductCreated"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/ProductCreated"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"PRODUCT_EXISTS, SKU_TAKEN, IDEMPOTENCY_KEY_REUSED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Products"],"summary":"List your products","x-scope":"products:read","parameters":[{"name":"skus","in":"query","required":false,"description":"Comma-separated SKUs (up to 200).","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"ISO 8601.","schema":{"type":"string"}},{"name":"includeInactive","in":"query","required":false,"description":"true to include archived products.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer","minimum":1}},{"name":"pageSize","in":"query","required":false,"description":"Entries per page.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"page":{"type":"integer","description":"Page number, from 1."},"pageSize":{"type":"integer","description":"Entries per page."},"total":{"type":"integer","description":"Entries matching, across all pages."},"hasMore":{"type":"boolean"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/products/batch":{"post":{"tags":["Products"],"summary":"Create up to 100 products; each succeeds or fails on its own","x-scope":"products:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Any unique string up to 200 characters. Retrying with the same key and body returns the first answer (with Idempotent-Replayed: true) instead of acting twice; kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/ProductInput"}},{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/ProductInput"}}},"required":["products"]}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/BatchResult"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/products/{sku}":{"get":{"tags":["Products"],"summary":"One product","x-scope":"products:read","parameters":[{"name":"sku","in":"path","required":true,"description":"Your SKU. URL-encode it.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/Product"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"PRODUCT_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webhook":{"get":{"tags":["Callbacks"],"summary":"Where your callbacks go","x-scope":"webhook:read","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/Webhook"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Callbacks"],"summary":"Set where your callbacks go, and which events","x-scope":"webhook:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"https address; \"\" turns callbacks off."},"events":{"type":"array","items":{"type":"string","description":""}}}},"example":{"url":"https://erp.example.com/stark/callback","events":["order.shipped","order.tracking_updated","inbound.received"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/Webhook"},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"400":{"description":"VALIDATION_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"CALLBACK_URL_REJECTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webhook/secret":{"post":{"tags":["Callbacks"],"summary":"Make a new signing secret (returned this once)","x-scope":"webhook:write","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"signingSecret":{"type":"string","description":"whsec_…"},"webhook":{"$ref":"#/components/schemas/Webhook"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webhook/test":{"post":{"tags":["Callbacks"],"summary":"Send a signed ping to your webhook address now","x-scope":"webhook:write","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"delivery":{"$ref":"#/components/schemas/Delivery"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"WEBHOOK_NOT_CONFIGURED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webhook/deliveries":{"get":{"tags":["Callbacks"],"summary":"Your recent callbacks and how each went","x-scope":"webhook:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Up to 200; default 50.","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Delivery"}}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webhook/deliveries/{id}/retry":{"post":{"tags":["Callbacks"],"summary":"Send a callback again now","x-scope":"webhook:write","parameters":[{"name":"id","in":"path","required":true,"description":"Delivery id. URL-encode it.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"delivery":{"$ref":"#/components/schemas/Delivery"}}},"requestId":{"type":"string","description":"Quote it when asking the warehouse about a call."}}}}}},"401":{"description":"UNAUTHENTICATED, INVALID_API_KEY, API_KEY_REVOKED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"CLIENT_INACTIVE, INSUFFICIENT_SCOPE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"DELIVERY_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"RATE_LIMITED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}