Delete SKU Order
DELETE/api/storefront/instances/:id/orders/:id2/sku-order
Delete the SKU.io sales order this store order created, and unlink it. The mirrored store order stays — only the SKU.io side is removed, through the normal sales-order path so allocations and stock movements unwind properly. Contrast with Delete Order, which removes the mirror itself.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Query parameter
archive_order(boolean, optional, default false) — also archive the mirrored store order, so the next import run does not simply recreate the SKU sales order you just deleted. Accepted in the request body too.
404 when the order has no SKU sales order to delete. 422 when the deletion itself failed — for example the SKU sales order has returns already consumed against it.
The response is the refreshed order, with sales_order_id, sales_order, sku_sales_order now null and archived_at set when you asked for it.
Requires the integrations.update permission.
Authentication: Bearer token (session or PAT).
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.