Refetch Order from Faire
POST/api/faire/orders/:order/refetch
Re-fetch the order from the Faire API. Updates local data and (if a linked SKU sales order exists) refreshes the SKU sales order to mirror Faire's latest state. Returns the updated Faire order object (with line_items, sales_order, faire_admin_url).
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Linked SKU.io product on line items: The sku_product_id, sku_product_route, and sku_product fields on each line item resolve via the explicit FaireProductOption → ProductListing → Product chain (joined on faire_variant_id). They populate only when the variant has been explicitly mapped via the Variants Listing page (Map / Smart Match / Bulk Map). String-based SKU matching is NOT used.
If Faire does not return the order (unavailable or rate limiting), the response is 422 and the order keeps its last synced details.
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 Entity
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.