Skip to main content

Bulk Delete Linked Sales Orders

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

Bulk-deletes the linked SKU.io sales orders for multiple Faire orders while keeping the Faire orders themselves intact. Only orders with a linked sales order in the targeted integration instance are processed — IDs from foreign instances or 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 — deletes 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 delete linked SKU orders for. Must be a non-empty array.
  • archive_faire_orders (optional, boolean) — When true, archives each Faire order after deleting its linked SKU sales order. Defaults to false.

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 deletion

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

Request​

Responses​

OK

Response Headers
    Content-Type