---
title: "product.update.batch"
method: POST
path: "/product.update.batch.json"
tags: ["product"]
---

# product.update.batch

`POST /product.update.batch.json`

## Request

- Base URL: `https://api.api2cart.com/v1.1`
- URL: `https://api.api2cart.com/v1.1/product.update.batch.json`
- Auth: API key in header `x-api-key` and API key in header `x-store-key`

Update products on the store.

## Request body

- ProductUpdateBatch
  - `nested_items_update_behaviour` 'replace' | 'merge': Determines how updates to nested items should be handled.<hr><div style="font-style:normal"> Values description: <div style="margin-left: 2%; padding-top: 2%"> <div style="font-size:85%"> <b> replace</b>: This option indicates that the nested items should be completely replaced with the new data provided. </br> <b> merge</b>: With this option, updates to nested items are merged with the existing data. </br> </div> </div></div>
  - `clear_cache` boolean
  - `reindex` boolean
  - `payload` object[], required: Contains an array of product objects. The list of properties may vary depending on the specific platform.
    - `id` string, required
    - `name` string
    - `description` string
    - `short_description` string
    - `sku` string
    - `model` string
    - `price` number
    - `special_price` number
    - `sprice_create` string
    - `sprice_expire` string
    - `cost_price` number
    - `old_price` number
    - `fixed_cost_shipping_price` number
    - `advanced_prices` object[]: If an empty array is passed, all entries will be deleted when the 'nested_items_update_behaviour' parameter is set to 'replace'.
      - `value` number, required
      - `group_id` integer
      - `quantity` number, required
    - `quantity` number
    - `increase_quantity` number
    - `reduce_quantity` number
    - `reserve_quantity` number
    - `store_id` string
    - `lang_id` string
    - `status` string
    - `type` string
    - `condition` string
    - `condition_description` string
    - `visible` string
    - `available_for_view` boolean
    - `available_for_sale` boolean
    - `avail_from` string
    - `weight` number
    - `length` number
    - `width` number
    - `height` number
    - `dimensions_unit` string
    - `weight_unit` string
    - `manage_stock` boolean
    - `in_stock` boolean
    - `backorder_status` string
    - `is_free_shipping` boolean
    - `is_virtual` boolean
    - `taxable` boolean
    - `downloadable` boolean
    - `warehouse_id` string
    - `tax_class_id` string
    - `categories_ids` string[]
    - `meta_title` string
    - `meta_description` string
    - `meta_keywords` string[]
    - `url` string
    - `seo_url` string
    - `manufacturer` string
    - `manufacturer_id` string
    - `mpn` string
    - `gtin` string
    - `upc` string
    - `isbn` string
    - `ean` string
    - `barcode` string
    - `images` object[]: Property 'nested_items_update_behaviour' does not apply. Specified items will be added to existing product images
      - `id` string
      - `name` string
      - `url` string, required
      - `label` string
      - `position` integer
      - `type` string
    - `related_products_ids` string[]: If an empty array is passed, all entries will be deleted when the 'nested_items_update_behaviour' parameter is set to 'replace'.
    - `up_sell_products_ids` string[]: If an empty array is passed, all entries will be deleted when the 'nested_items_update_behaviour' parameter is set to 'replace'.
    - `cross_sell_products_ids` string[]: If an empty array is passed, all entries will be deleted when the 'nested_items_update_behaviour' parameter is set to 'replace'.
    - `tags` string[]
    - `search_keywords` string[]
    - `harmonized_system_code` string
  - `idempotency_key` string: A unique identifier associated with a specific request. Repeated requests with the same <strong>idempotency_key</strong> return a cached response without re-executing the business logic. <strong>Please note that the cache lifetime is 15 minutes.</strong>

## Response `200`

successful operation

- object
  - `return_code` integer
  - `return_message` string
  - `result` object
    - `job_id` string

---

[API](https://skmtc.dev/api2cart/apis/api2cart-openapi.md) · [All operations](https://skmtc.dev/api2cart/apis/api2cart-openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/api2cart/apis/api2cart-openapi/revisions/c34440741693?raw)