Skip to main content
PATCH
Update a product variation

Authorizations

Authorization
string
header
required

OAuth 2.0 with opaque bearer tokens. Authorization-code requests require PKCE S256.

Headers

X-API-Version
string

Pin a dated API release (YYYY-MM-DD). Omit for the latest (2026-06-09). Unknown values return 400 unsupported_api_version; the resolved version is echoed back in the X-API-Version response header.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-06-09"

Path Parameters

productId
string<uuid>
required
variationId
string<uuid>
required

Body

application/json
name
string
description
string
price
number
unit
string
Example:

"EA"

sku
string
barcode
string
ebt_eligible
boolean
wic_eligible
boolean
organic_certified
boolean
kosher_certified
boolean
tobacco
boolean
alcohol_class
enum<string>
Available options:
beer,
wine,
liquor,
cider,
sake,
rtd
controlled_class
enum<string>
Available options:
cbd,
hemp,
thc
allergens
enum<string>[]
Available options:
gluten,
dairy,
nut,
soy,
shellfish,
egg,
wheat,
fish,
sesame
tax_code
string
tags
string[]
square_sync_enabled
boolean
default:true
is_archived
boolean

Response

Variation updated.