Skip to main content

Recache Inventory Quantities

POST 
/api/faire/instances/:integrationInstance/inventory/recache

Recalculate the SKU.io sellable quantities cached for every listing on a Faire integration instance.

Authorization

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

Path Parameters:

  • integrationInstance - The ID of the integration instance

Behavior:

  • Dispatches a background job immediately and returns — the recache runs asynchronously
  • The job marks every cached row for the instance as needing recalculation, then recomputes each listing's SKU.io quantity and writes fresh values with updated timestamps
  • Use this when SKU.io quantities in the inventory comparison look stale, or to clear rows stuck in the needs_recalc status so the next push can include them
  • Progress can be monitored via the returned tracked_job_log_id

Not available for FBF instances — returns 422, since Faire manages inventory in FBF (Fulfilled by Faire) mode.

Response: Returns immediately with a tracked job log ID:

  • data.tracked_job_log_id - ID for monitoring the background recache
  • message - Confirmation that the recache started

Request​

Responses​

OK

Response Headers
    Content-Type