Variant Groups

Variant groups — size/color/SKU matrices reusable across products. Includes the cross-platform variant attribute lookup.

📄️ Get variant attributes by platform

Get available variant dimension attributes for a specific platform. These attributes define what types of variant dimensions can be used (Size, Color, Type, etc.). Use these attribute names when creating dimension_labels in POST /group-variants.

📄️ List variant groups

Browse available variant group configurations (size/color combinations). Use this to find variant groups, then get full details with GET /group-variants/{id}.

📄️ Create variant group

Create a new variant group with dimension labels and SKU combinations. Use dimension labels (variant0, variant1, variant2) to define product options like Size, Color, Material. Keys start from variant0 (0-indexed). Each variant combination must have unique values, price, and quantity. After creation, use GET /group-variants/{id} to retrieve full details for Deploy API.

📄️ Get variant group details

Get complete variant group structure with SKUs, pricing, and inventory. **IMPORTANT**: You can copy the entire 'data' object from this response and use it as the 'variants' parameter in POST /deploy-product API.

📄️ Update variant group

Update variant group name and category. This updates the metadata of the variant group, not the SKU configurations (use PUT /group-variants/{id}/detail/{detail_id} to update individual SKUs).

📄️ Delete variant group

Delete a variant group and all its SKU configurations. **Warning**: This action cannot be undone. Make sure the variant group is not being used in any active product deployments before deleting.

📄️ Update variant SKU detail

Update a single SKU configuration within a variant group. This allows you to change the variant values (e.g., size, color), price, and quantity for a specific SKU. **Note**: The variant field names (variant0, variant1, etc.) are dynamic based on the variant group's structure.