Skip to main content
PATCH
Update product inventory

Authorizations

x-access-token
string
header
required

JWT minted from a merchant API key (mk_live_…) by POST /authenticate. Send the token value directly, with no "Bearer" prefix. Tokens last 14 days and can be renewed at POST /refresh-token; revoking the key refuses the next request made with any token minted from it.

Path Parameters

productId
string
required

A product ObjectId, a Shopify product GID or a numeric Shopify product id. Malformed is 400.

Body

application/json
variants
object[]
required

Per variant × location quantity updates

Required array length: 1 - 100 elements
mode
enum<string>
default:set

set = absolute quantity; adjust = delta

Available options:
set,
adjust
reason
string

Optional audit reason

Maximum string length: 255

Response

Applied per variant; failed variants are listed in data.errors

success
boolean
data
object