Skip to main content
POST
/
admin
/
products
/
{id}
curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "Linen Shirt v2", "status": "published"}'

{
  "product": {
    "id": "prod_01HXYZABCDEF",
    "title": "Linen Shirt v2",
    "handle": "linen-shirt",
    "status": "published",
    "updated_at": "2026-06-02T09:00:00.000Z"
  }
}
Updates the product’s details; only the provided fields are changed.

​
Path parameters

​
id
string
required
The product’s ID.

​
Body parameters

​
title
string
Product title.
​
subtitle
string
Product subtitle.
​
description
string
Product description.
​
handle
string
Unique URL-safe handle.
​
status
string
One of draft, proposed, published, rejected.
​
is_giftcard
boolean
Whether the product is a gift card.
​
discountable
boolean
Whether discounts can apply to the product.
​
thumbnail
string
URL of the product thumbnail.
​
images
object[]
Product images; replaces the existing set.
​
external_id
string
ID of the product in an external system.
​
type_id
string
ID of the product type.
​
collection_id
string
ID of the collection to assign the product to.
​
categories
object[]
Categories to assign; replaces the existing set.
​
tags
object[]
Tags to assign; replaces the existing set.
​
options
object[]
Product options; replaces the existing set.
​
variants
object[]
Variants to upsert; include id to update an existing variant.
​
weight
number
Product weight.
​
length
number
Product length.
​
height
number
Product height.
​
width
number
Product width.
​
hs_code
string
Harmonized System code.
​
mid_code
string
Manufacturer identification code.
​
origin_country
string
Country of origin.
​
material
string
Product material.
​
metadata
object
Custom key-value data.
​
additional_data
object
Custom data passed to workflow hooks.

​
Response

​
product
object
curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "Linen Shirt v2", "status": "published"}'

{
  "product": {
    "id": "prod_01HXYZABCDEF",
    "title": "Linen Shirt v2",
    "handle": "linen-shirt",
    "status": "published",
    "updated_at": "2026-06-02T09:00:00.000Z"
  }
}