Create dictionary Category Level Attribute (CLA) and schedule propagation task.

Attaches a dictionary attribute definition to the category with no values selected yet. Values are selected
with POST /catalogs/nodes/{id}/attributes/{attributeDefinitionId}/dictionary/values, which attaches the
attribute itself when it is missing - so this call is only needed when the attribute should be in place
before any value is chosen. Handles dictionary definitions only and fails when the category already has this
definition as a CLA. An attribute inherited from a parent
category does not count as assigned here, so the call succeeds and creates an assignment on this category
that overrides the inherited one.

The attribute is stored on the category immediately, while adding it to products runs as a background task. That
task covers the products in this category; the products in its sub-categories are reached only once propagation
is switched on for this attribute, which is off on a newly created CLA - switch it on, as well as mandatory,
with PATCH /catalogs/nodes/{id}/attributes/{attributeDefinitionId}. The task ID is returned in the
Resource-Id response header and Location points at GET /async/status/{taskId}, which reports whether the
propagation has finished.

For more detailed information on how to work with Category Level Attributes in Bluestone PIM, refer to our help
pages Category Level Attributes (CLA).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The ID for the catalog node/category.

Example: 634c26e14cedfd0001775e9f

string
required

The ID for the attribute definition.

Example: 634c26e14cedfd0001775e9e

Headers
string

Specifies the context in which to operate. If omitted, the default context en is used.

In Bluestone PIM, the context is generally synonymous with the language setting. The context determines how product information is tailored and presented based on language or other local specifications.

For more detailed information on how context relates to language settings in Bluestone PIM, refer to the Languages and Context documentation.

Note: The default context is identified by the ID "en". IDs for additional contexts begin with a lowercase "L", not with the digit "1", followed by a number. This naming convention helps distinguish between default and custom contexts within Bluestone PIM.

Responses
202

Accepted

The request has been accepted for processing, but the processing has not been completed.

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