Update variant level attribute (VLA) for multiple products.

Sets the VLA settings of the given attribute on every listed GROUP product and propagates the attribute
down to their assigned VARIANT products. The bulk twin of
PUT /products/{id}/variants/attributes/{definitionId}.

For more detailed information on how to work with Variant Level Attributes (VLA) in Bluestone PIM, refer to our
help pages The data model - Variant Level Attribute (VLA).

Variant Attribute Configuration Validation

Variant-defining attributes must be properly configured to be propagated to variants.
This error occurs when a variant level attribute is not configured to be propagated to its variants.

Attributes marked as definingAttributes, locked or mandatory require copy = true. The same set of
flags is applied to every listed product, so the rule is checked once against the request body.

If copy is set to false (or omitted), the configuration becomes inconsistent and the request is rejected
with HTTP 400 Bad Request.

The whole request is validated before anything is written. If any listed product does not exist, is not a
variant group or family product, or does not have the attribute assigned, the request is rejected and no
job is created.

The work then runs as a background job. Poll GET /async/status/{taskId} for its status; the task ID is
returned in the Resource-Id header and the Location header points at the status resource.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
boolean
Defaults to false

When propagating this Variant Level Attribute to variants, this flag controls what to do
if a variant already has this attribute assigned:

false = Keep existing value, only update empty ones

true = Override existing value

If omitted, the default value false will be used.

Body Params
string
required

Internal ID of the single attribute definition whose VLA settings are being set.

boolean | null

Variant copy flag. Omitted = removed.

boolean | null

Variant defining attributes flag. Omitted = removed.

boolean | null

Lock flag to determine that attribute is locked/unlocked. Omitted = removed.

boolean | null

Variant mandatory flag. Omitted = removed.

productIds
array of strings, unique
required
length between 1 and 100

Internal IDs of the products to apply the settings to; 1 to 100 IDs. The operation fails if any of them does not exist.

productIds*
Responses
200

OK

The job was scheduled.

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json