Sync Linked Sales Order

POST 
/api/faire/instances/:integrationInstance/orders/:order/update-sku-order

Refetches the order from Faire and synchronously syncs the linked SKU.io sales order's status fields (order_status, payment_status, last_synced_from_sales_channel_at).

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Path Parameters:

• integrationInstance — The ID of the integration instance
• order — The internal Faire order ID (faire_orders.id)

Body: Empty.

Response Fields:

• message — Human-readable result
• refetched — true when the latest order state was successfully fetched from Faire before the SKU sync

Errors:

• 403 when the order does not belong to the supplied integration instance
• 404 when the Faire order has no linked SKU sales order
• 422 when the SKU sales order update fails (e.g., refetch error or downstream validation)

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 — 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.

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.