Refetch Order from Store
POST/api/storefront/instances/:id/orders/:id2/refetch
Re-read this one order from the store and update the mirror from it, then apply any store-side transitions it implies (cancel the SKU sales order if the store cancelled, record a payment the store has since taken). Runs inline and returns the refreshed order.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
422 when the store could not be reached or refused the read; the message carries the store's error text.
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.