Skip to main content

Bulk Sync Linked Sales Orders

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

Bulk-refetches Faire orders and re-syncs each linked SKU.io sales order's status fields (order_status, payment_status, last_synced_from_sales_channel_at). Only orders with a linked SKU sales order in the targeted integration instance are processed — foreign-instance IDs and orders without a linked SKU order are silently skipped.

Authorization

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

  • 0 eligible orders — returns tracked_job_log_id: null synchronously.
  • 1 eligible order — updates synchronously and returns tracked_job_log_id: null.
  • >1 eligible orders — dispatches a background job and returns the tracked-job ID for progress polling.

Path Parameters:

  • integrationInstance — The ID of the integration instance

Body:

  • ids (required, array of integers) — Faire order IDs to update linked SKU orders for. Must be a non-empty array.

Response Fields:

  • message — Human-readable result
  • tracked_job_log_id — Tracked-job log ID when a job was dispatched, otherwise null
  • total_orders (only when a tracked job was dispatched) — Number of eligible orders queued for update

Tracked Job Name: Bulk Update SKU Orders: {instance_name} (frontend lastCompletedJob watcher matches with startsWith)

Request​

Responses​

OK

Response Headers
    Content-Type