Skip to main content

Unmap Single Variant

DELETE 
/api/faire/instances/:integrationInstance/products/:option/map

Removes the SKU.io product link for a single Faire variant by deleting the associated product_listings row. Idempotent — calling on a variant that wasn't mapped returns data.unmapped = false with status 200.

Authorization

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

Path Parameters:

  • integrationInstance - Faire integration instance ID. Returns 404 if the variant doesn't belong to this instance.
  • option - Faire product option (variant) ID.

Response:

  • data.unmapped (boolean) - true if a mapping was deleted, false if the variant wasn't mapped.
  • message (string) - Human-readable status (Product unmapped or Product was not mapped).

Errors:

  • 404 - The variant does not belong to the given integration instance.

Note: faire_product_id is the Faire-issued product ID (e.g. p_3bz2tdhtkq), sourced from the parent FaireProduct. It is NOT the internal faire_product_options.faire_product_id foreign key.

Request​

Responses​

OK

Response Headers
    Content-Type