Skip to main content
PUT
Set a configurable product's variant axes

Authorizations

Authorization
string
header
required

Use a project API key from Settings > API Access. Send it as Authorization: Bearer wpk_.... See authentication and scopes for setup and permissions.

Headers

Idempotency-Key
string

Reuse this key for retries of the same write. Scoped to this API key; retained for 30 days, after which the key may be reused. Different requests with the same key return 409.

Required string length: 1 - 128
Pattern: ^[!-~]+$

Path Parameters

product_id
integer
required

Body

application/json
attribute_codes
string[]
required

Attribute codes of this project, in axis order. An empty list means the product has no axes.

Maximum array length: 32
Required string length: 1 - 255

Response

OK

product_id
integer
required
source
string
required

One of parent_override, family, inferred, stored_import, none.

axes
VariantAxisOut · object[]
required
incomplete_variant_ids
integer[]
required

Variants missing a value for at least one axis.

duplicate_variant_ids
integer[][]
required

Groups of variants sharing one axis combination.

warnings
string[]
required