---
title: "Update a product"
method: PATCH
path: "/v1/commerce/products/{productId}"
tags: ["Commerce"]
---

# Update a product

`PATCH /v1/commerce/products/{productId}`

Partial-updates the product's own fields; at least one besides
`accountId` is required. `tags` replaces the full list. Change prices
with `POST /v1/commerce/products/{productId}/price` and status with
`POST /v1/commerce/products/state`.

## Path parameters

- `productId` string, required

## Request body

- object
  - `accountId` string, required
  - `title` string
  - `descriptionHtml` string
  - `handle` string
  - `vendor` string
  - `productType` string
  - `tags` string[]
  - `seo` object
    - `title` string
    - `description` string

## Response `200`

Product updated

- object
  - `product` CommerceProduct — A product on a connected store, in the platform-neutral shape.
    - `id` string — Platform-native product id.
    - `accountId` string
    - `platform` 'shopify'
    - `title` string
    - `descriptionHtml` string, nullable
    - `handle` string, nullable — URL slug of the product.
    - `vendor` string, nullable
    - `productType` string, nullable
    - `tags` string[]
    - `status` 'active' | 'draft' | 'pending_review' | 'rejected' | 'inactive' | 'archived' | 'deleted' — Zernio product status. The platform value is returned as platformStatus. Shopify: ACTIVE, DRAFT and ARCHIVED map to the same names; UNLISTED maps to inactive.
    - `platformStatus` string — The raw status on the platform, e.g. ACTIVE on Shopify.
    - `featuredImage` CommerceImage
      - `id` string, nullable — Media id, used to reorder or remove images. Null for collection images.
      - `url` string
      - `altText` string, nullable
    - `images` CommerceImage[] — First 20 images, in store order.
      - `id` string, nullable — Media id, used to reorder or remove images. Null for collection images.
      - `url` string
      - `altText` string, nullable
    - `options` object[] — Option axes (e.g. Size, Color) and their values.
      - `name` string
      - `values` string[]
    - `variants` CommerceVariant[] — First 100 variants.
      - `id` string — Platform-native variant id.
      - `title` string — Option combination label, e.g. "S / Blue".
      - `sku` string, nullable
      - `barcode` string, nullable
      - `price` CommerceMoney — An exact amount of money. The amount is a decimal string so cents are never lost to floating point.
        - `amount` string, required
        - `currency` string, required — ISO 4217 code. Never null: the store currency is filled in when the platform omits it.
      - `compareAtPrice` CommerceMoney — An exact amount of money. The amount is a decimal string so cents are never lost to floating point.
        - `amount` string, required
        - `currency` string, required — ISO 4217 code. Never null: the store currency is filled in when the platform omits it.
      - `inventoryQuantity` integer, nullable — Units on hand; null when inventory is not tracked.
      - `availableForSale` boolean, nullable
      - `options` object[]
        - `name` string
        - `value` string
    - `totalInventory` integer, nullable
    - `url` string, nullable — Public storefront URL; null while the product is not published.
    - `seo` object
      - `title` string, nullable
      - `description` string, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
    - `publishedAt` string, date-time, nullable
    - `platformData` object, nullable — Platform-only fields. Null when the platform has none.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Account not found (code account_not_found) or product not found (code product_not_found).
- `429` — Rate limited, either by Zernio or by the platform. Retry later.

## Changes

- **2026-09-30** `16a7b9d5373e` — 1 info
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `400`
- **2026-09-29** `69bbe3da3a18` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/commerce/products/:productId/patch.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/16a7b9d5373e?raw)