Update SKU Order
POST/api/storefront/instances/:id/orders/:id2/update-sku-order
Re-apply this order's mirrored data to its linked SKU.io sales order. The store is not called: this is the SKU.io-side half of a sync, using whatever the mirror already holds. A store cancellation cancels the SKU sales order, a payment is recorded once, and the buyer's requested delivery method is refreshed.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Use Refetch Order from Store first (or Bulk Update SKU Orders, which does both) when you want the store's current state rather than the mirror's.
422 when the order has no SKU sales order to update.
The payload is the full order: every field from the list plus complete line objects (each with its SKU.io product link and, when the store product has been imported, its channel product link), the shipments SKU.io has pushed, the linked SKU.io sales order with its fulfillments, the shipments the store itself reports (store_fulfillments), and the stored store payload (raw_data). items_count is not included here — count items.
Requires the integrations.sync permission.
Authentication: Bearer token (session or PAT).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Content
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.