Update group level attribute (VLA) for multiple products.

Sets the VLA settings of the given attribute on every listed FAMILY product and propagates the attribute
down to their assigned GROUP products. The bulk twin of
PUT /products/{id}/groups/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).

Group Attribute Configuration Validation

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

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
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 groups, this flag controls what to do if
a group 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