Refresh Single Order from Shopify

POST 
/api/shopify/:integrationInstance/orders/refresh-order

Fetches one order live from the Shopify Admin API by its Shopify order ID, updates the local copy synchronously, and returns the refreshed order.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Authentication: Requires Bearer token.

Body fields:

• uniqueId (string, required): the Shopify order ID (numeric ID from Shopify, not the SKU.io row ID).

Returns 404 when the order cannot be found in Shopify.

Requires the integrations.sync permission.

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden

Response Headers

Content-Type

404

Not Found

Response Headers

Content-Type

422

Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.

429

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.