---
title: "Update the live changes of an individual or base product"
method: POST
path: "/v1/products/{productId}/live-changes"
tags: ["Manage Product (Asynchronous API)"]
---

# Update the live changes of an individual or base product

`POST /v1/products/{productId}/live-changes`

Update the live changes to an existing individual product or base product asynchronously. The changes will go live immediately. You do not need to deploy these changes. Live changes for individual or base product includes catalog, category, price.

## Path parameters

- `productId` string, required

## Headers

- `x-erid-as-pid` boolean

## Request body

- UpdateProductLiveChange — The changed attributes under this object will go live immediately. You do not need to deploy these changes. You can use these attributes to insert live changes when creating a product. After creating the product, the fields are read-only. You can apply live changes by using the POST /v1/products/{productId}/live-changes API.
  - `externalReferenceId` string — The external reference identifier. A unique identifier for the product from the Digital River client.
  - `catalogs` object[] — The collection of products for sale on your site. A catalog contains categories to organize your products.
    - `catalogId` string — The catalog identifier.
    - `categories` object[] — Categories are used to organize products within a catalog and often appear on the store to help shoppers locate products and navigate the store/site.
      - `categoryId` string
    - `prices` object[] — The price of the product by currency and locale.
      - `type` 'listPrice' | 'msrp' — The type of the price list. Used to classify the prices in a price list. A price list type may also indicate how the price list or pricing will be used. For example, you can create a MSRP list, a subscription renewal price list, and so on.
      - `prices` object[] — The price of the product by currency and locale.
        - `currency` string — A three-letter ISO 4217 currency code.
        - `locale` string — Optional. If your store supports multiple locales, your price list will contain space for you to enter pricing in currencies used by the locales supported by your store. The price you enter for a product in a currency will be used by any locale that uses the currency in which you entered the price.
        - `configuredPrice` number — The configured price for the product.

## Response `202`

Successful response.

- ProductAdminApiAsyncResponse
  - `taskId` string — The task identifier received in the response when you create or update a product (synchronous API).
  - `receivedTime` string — The date and time when Global Commerce received the task.
  - `taskStatus` 'PUBLISHED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' — The status of the task.
  - `requestType` 'CREATE_PRODUCT' | 'CREATE_VARIATION' | 'UPDATE_PRODUCT' | 'UPDATE_VARIATION' | 'DELETE_VARIATION' | 'DELETE_LOCALE' | 'DEPLOY_PRODUCT' | 'RETIRE_PRODUCT' | 'UPDATE_PRODUCT_LIVE_CHANGE' | 'UPDATE_VARIATION_LIVE_CHANGE' — The request type for this task.

## Other responses

- `401` — * The API key is invalid if you are HTTP Basic Authentication.
- `403` — * The token is invalid if you are using Bearer Token Authentication.
- `404` — * Product was not found.
- `409` — * Unable to handle request because it conflicts with other requests.

---

[API](https://skmtc.net/digitalriver/apis/commerce-api-suite-admin-apis.md) · [All operations](https://skmtc.net/digitalriver/apis/commerce-api-suite-admin-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/commerce-api-suite-admin-apis/revisions/a6efafc1669c/schema)