Skip to main content

Bulk Operation (Tracked)

POST 
/api/faire/instances/:integrationInstance/products/bulk-tracked

Dispatches a BulkFaireProductOperationTrackedJob background job that performs the bulk action across the resolved selection. Returns immediately with a tracked job log ID — progress is visible in the global Job Progress Tray and pollable via the bulk-progress endpoint.

Use this variant for All Filtered requests where the count may be large enough to exceed an HTTP timeout. For Selected Only with small counts, the synchronous variant is faster.

Path Parameters:

  • integrationInstance (required) - The ID of the Faire integration instance.

Body: Same shape as the synchronous bulk endpoint. See its description for full field-by-field documentation. The selection is resolved server-side BEFORE the job is dispatched, so the response includes the tracked-job ID only when at least one record matched.

Response (200):

  • data.tracked_job_log_id - The ID of the dispatched tracked job. Pass to bulk-progress/:trackedJobLogId (or the global /api/tracked-job-logs/:id) to poll progress.
  • message - Human-readable status string.

Errors:

  • 422 when no records resolve from the selection.
  • 422 when validation fails on the body shape.

Request​

Responses​

Successful response