latestOpenAPI 3.0.32026-08-22505302.1 MB

60d6c901bc4e

Products/Styles

put/api/styles/{id}

Path parameters

idstring required

Request body

namestring required

Display name of the product.

forCompanyIdstring

Retraced ID of the brand or company that owns this product.

descriptionstring

Free-text product description. Nullable.

genderstring

Product gender classification. Known values: MALE, FEMALE, UNISEX. Nullable.

brandsstring[]

User-defined brand labels associated with this product. Free-text strings set by the brand — no fixed taxonomy or lookup endpoint. Use to identify which sub-brand a product is sold under (e.g. 'Columbia', 'Prana').

departmentsstring[]

User-defined department labels. Free-text strings set by the user — no fixed taxonomy or lookup endpoint.

seasonsstring[]

User-defined season labels. Free-text strings set by the user — no fixed taxonomy or lookup endpoint.

collectionsstring[]

User-defined collection labels. Free-text strings set by the user — no fixed taxonomy or lookup endpoint.

claimIntentionsstring[]
customPropertiesstring
suppliersstring[]

Array of supplier IDs that can fulfil this product, including the main supplier and any alternates. Use the companyId values here to query GET /supply-chains/:styleId for detailed supply chain data.

mainSupplierstring

The single designated primary supplier for this product. Null if not set. A product can have many entries in suppliers but at most one mainSupplier.

vendorsstring[]
imagesFileIdsstring[]
isStoryActiveboolean
externalIdstring

Your own identifier for this product. Unique per company across all product levels. Can be used in place of the Retraced ID on any product ID field in this API. On update it is only written when the field is present in the body — omitting it keeps the stored value, sending null clears it.

styleTypeIdstring
styleLevelIdstring

Response

Default Response