Update Product Catalog Items

This endpoint asynchronously updates specific data elements for existing SKUs in a DRAFT version's product catalog. Unlike the POST endpoint, this endpoint does not create new products — it only modifies data elements for SKUs that already exist in the catalog.

The mode query parameter controls the update behavior: UPDATE merges the provided data with existing data, while REPLACE replaces all entries within each included data category.

This operation returns a request_id for tracking. Requests targeting an ACTIVE or DEACTIVATED version will fail.

Path Params
string
required
length ≤ 16

The identifier of the DRAFT version whose catalog should be updated.

Query Params
string
enum
required

The update mode. UPDATE merges the provided data with existing data for each SKU; unspecified data is preserved. REPLACE replaces all entries within each included data category; entries not present in the request are removed from that category.

Allowed:
Body Params
products
array of objects

List of existing products whose data elements should be updated. Each element must reference an existing SKU in the catalog.

products
bundles
array of objects

List of existing bundles whose data elements should be updated. Each element must reference an existing bundle SKU in the catalog.

bundles
Responses

400

Bad Request. The request payload is invalid, a mandatory field is missing, or the specified version is not in DRAFT status.

403

Unauthenticated. The Authorization token is missing or invalid.

Language
Credentials
Bearer
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json