v1
latestOpenAPI 3.0.32026-07-24614422630.2 KBUpdate Product Catalog Items
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.
This endpoint operates in one of two modes, defined by the mode query parameter:
UPDATE mode: Only the data elements explicitly included in the request body are added or updated. Any existing data not referenced in the request remains unchanged.
REPLACE mode: Each data category included in the request (e.g., product_attributes, pricing_rules) completely replaces the corresponding data for that SKU. Entries within an included category that are not present in the request are removed. Categories not referenced at all in the request are left untouched.
This operation returns a request_id for you to track the progress. Requests targeting an ACTIVE or DEACTIVATED version will fail.
Path parameters
The identifier of the DRAFT version whose catalog should be updated.
Query parameters
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.
Request body
Example request
{
"products": [
{
"product_pricing": {
"pricing_rules": [
{
"volume_discount": {
"Quantity": "VolD1",
"Duration": "VolD2"
}
}
]
}
}
],
"bundles": [
{
"product_pricing": {
"pricing_rules": [
{
"volume_discount": {
"Quantity": "VolD1",
"Duration": "VolD2"
}
}
]
}
}
]
}Response
The request was accepted and will be processed asynchronously.