For the complete documentation index, see llms.txt. This page is also available as Markdown.

Attributes

Attributes are the central element in the system. They describe the data fields available on entities such as products, variants, categories and global list values. A range of attribute types exist to allow for flexible modelling of your data structure.

Get all attributes in the system

get
Authorizations
AuthorizationstringRequired
Responses
200

OK

application/json

Represents an attribute in Struct PIM which can be attached to product, variant or category data models

Uidstring · uuidOptional

Unique id of attribute

Aliasstring · nullableOptional

Unique alias of attribute. Max length is 50 characters and can only consist of letters a-z/A-Z and numbers 0-9 (but cannot start with a number)

BackofficeNamestring · nullableOptional

The name of the attribute displayed to the editor in the PIM backoffice

BackofficeDescriptionstring · nullableOptional

The description of the attribute displayed to the editor in the PIM backoffice

AttributeGroupUidstring · uuid · nullableOptional

The id of the attribute group this attribute is placed within

AttributeScopesstring · uuid[] · nullableOptional

Unique ids of the attribute scopes this attribute is placed within

LocalizedbooleanOptional

Indicates whether values of this attribute are localized

FallbackLanguageinteger · int32 · nullableOptional

Indicates a fallback language in case attribute is localized and no value is added to a specific language

DimensionUidstring · uuid · nullableOptional

Unique id of Dimension to segment values of this attribute on

FallbackSegmentstring · uuid · nullableOptional

Indicates a fallback segment in case attribute is dimensioned and no value is added to a specific segment of that dimension

ReadOnlybooleanOptional

Indicates whether this attribute is always readonly. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

MandatorybooleanOptional

Indicates whether this attribute is always mandatory. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

Columnsinteger · int32Optional

The number of columns this attribute should span in the PIM backoffice (1-12)

UnchangeablebooleanOptional

Indicates whether this attribute cannot change its value, once it has a value assigned. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

AttributeTypestring · nullableRead-onlyOptional

Type of attribute

DisableRevisionLoggingbooleanOptional

Disable all revision logging for this attribute

DisableIndexingbooleanOptional

Disable indexing for this attribute

get/v1/attributes
200

OK

Create an attribute

post
Authorizations
AuthorizationstringRequired
Body

Represents an attribute in Struct PIM which can be attached to product, variant or category data models

Uidstring · uuidOptional

Unique id of attribute

Aliasstring · nullableOptional

Unique alias of attribute. Max length is 50 characters and can only consist of letters a-z/A-Z and numbers 0-9 (but cannot start with a number)

BackofficeNamestring · nullableOptional

The name of the attribute displayed to the editor in the PIM backoffice

BackofficeDescriptionstring · nullableOptional

The description of the attribute displayed to the editor in the PIM backoffice

AttributeGroupUidstring · uuid · nullableOptional

The id of the attribute group this attribute is placed within

AttributeScopesstring · uuid[] · nullableOptional

Unique ids of the attribute scopes this attribute is placed within

LocalizedbooleanOptional

Indicates whether values of this attribute are localized

FallbackLanguageinteger · int32 · nullableOptional

Indicates a fallback language in case attribute is localized and no value is added to a specific language

DimensionUidstring · uuid · nullableOptional

Unique id of Dimension to segment values of this attribute on

FallbackSegmentstring · uuid · nullableOptional

Indicates a fallback segment in case attribute is dimensioned and no value is added to a specific segment of that dimension

ReadOnlybooleanOptional

Indicates whether this attribute is always readonly. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

MandatorybooleanOptional

Indicates whether this attribute is always mandatory. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

Columnsinteger · int32Optional

The number of columns this attribute should span in the PIM backoffice (1-12)

UnchangeablebooleanOptional

Indicates whether this attribute cannot change its value, once it has a value assigned. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

AttributeTypestring · nullableRead-onlyOptional

Type of attribute

DisableRevisionLoggingbooleanOptional

Disable all revision logging for this attribute

DisableIndexingbooleanOptional

Disable indexing for this attribute

Responses
200

OK

No content

post/v1/attributes

No content

Update an attribute

put
Authorizations
AuthorizationstringRequired
Body

Represents an attribute in Struct PIM which can be attached to product, variant or category data models

Uidstring · uuidOptional

Unique id of attribute

Aliasstring · nullableOptional

Unique alias of attribute. Max length is 50 characters and can only consist of letters a-z/A-Z and numbers 0-9 (but cannot start with a number)

BackofficeNamestring · nullableOptional

The name of the attribute displayed to the editor in the PIM backoffice

BackofficeDescriptionstring · nullableOptional

The description of the attribute displayed to the editor in the PIM backoffice

AttributeGroupUidstring · uuid · nullableOptional

The id of the attribute group this attribute is placed within

AttributeScopesstring · uuid[] · nullableOptional

Unique ids of the attribute scopes this attribute is placed within

LocalizedbooleanOptional

Indicates whether values of this attribute are localized

FallbackLanguageinteger · int32 · nullableOptional

Indicates a fallback language in case attribute is localized and no value is added to a specific language

DimensionUidstring · uuid · nullableOptional

Unique id of Dimension to segment values of this attribute on

FallbackSegmentstring · uuid · nullableOptional

Indicates a fallback segment in case attribute is dimensioned and no value is added to a specific segment of that dimension

ReadOnlybooleanOptional

Indicates whether this attribute is always readonly. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

MandatorybooleanOptional

Indicates whether this attribute is always mandatory. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

Columnsinteger · int32Optional

The number of columns this attribute should span in the PIM backoffice (1-12)

UnchangeablebooleanOptional

Indicates whether this attribute cannot change its value, once it has a value assigned. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

AttributeTypestring · nullableRead-onlyOptional

Type of attribute

DisableRevisionLoggingbooleanOptional

Disable all revision logging for this attribute

DisableIndexingbooleanOptional

Disable indexing for this attribute

Responses
200

OK

No content

put/v1/attributes

No content

Delete an attribute

delete
Authorizations
AuthorizationstringRequired
Query parameters
uidstring · uuidOptional

Unique id of attribute to delete

Responses
200

OK

No content

delete/v1/attributes

No content

Get a specific attribute

get
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Unique id of attribute to get

Responses
200

OK

application/json

Represents an attribute in Struct PIM which can be attached to product, variant or category data models

Uidstring · uuidOptional

Unique id of attribute

Aliasstring · nullableOptional

Unique alias of attribute. Max length is 50 characters and can only consist of letters a-z/A-Z and numbers 0-9 (but cannot start with a number)

BackofficeNamestring · nullableOptional

The name of the attribute displayed to the editor in the PIM backoffice

BackofficeDescriptionstring · nullableOptional

The description of the attribute displayed to the editor in the PIM backoffice

AttributeGroupUidstring · uuid · nullableOptional

The id of the attribute group this attribute is placed within

AttributeScopesstring · uuid[] · nullableOptional

Unique ids of the attribute scopes this attribute is placed within

LocalizedbooleanOptional

Indicates whether values of this attribute are localized

FallbackLanguageinteger · int32 · nullableOptional

Indicates a fallback language in case attribute is localized and no value is added to a specific language

DimensionUidstring · uuid · nullableOptional

Unique id of Dimension to segment values of this attribute on

FallbackSegmentstring · uuid · nullableOptional

Indicates a fallback segment in case attribute is dimensioned and no value is added to a specific segment of that dimension

ReadOnlybooleanOptional

Indicates whether this attribute is always readonly. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

MandatorybooleanOptional

Indicates whether this attribute is always mandatory. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

Columnsinteger · int32Optional

The number of columns this attribute should span in the PIM backoffice (1-12)

UnchangeablebooleanOptional

Indicates whether this attribute cannot change its value, once it has a value assigned. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

AttributeTypestring · nullableRead-onlyOptional

Type of attribute

DisableRevisionLoggingbooleanOptional

Disable all revision logging for this attribute

DisableIndexingbooleanOptional

Disable indexing for this attribute

get/v1/attributes/{uid}

Get a batch of attributes

post
Authorizations
AuthorizationstringRequired
Bodystring · uuid[]
string · uuid[]Optional
Responses
200

OK

application/json

Represents an attribute in Struct PIM which can be attached to product, variant or category data models

Uidstring · uuidOptional

Unique id of attribute

Aliasstring · nullableOptional

Unique alias of attribute. Max length is 50 characters and can only consist of letters a-z/A-Z and numbers 0-9 (but cannot start with a number)

BackofficeNamestring · nullableOptional

The name of the attribute displayed to the editor in the PIM backoffice

BackofficeDescriptionstring · nullableOptional

The description of the attribute displayed to the editor in the PIM backoffice

AttributeGroupUidstring · uuid · nullableOptional

The id of the attribute group this attribute is placed within

AttributeScopesstring · uuid[] · nullableOptional

Unique ids of the attribute scopes this attribute is placed within

LocalizedbooleanOptional

Indicates whether values of this attribute are localized

FallbackLanguageinteger · int32 · nullableOptional

Indicates a fallback language in case attribute is localized and no value is added to a specific language

DimensionUidstring · uuid · nullableOptional

Unique id of Dimension to segment values of this attribute on

FallbackSegmentstring · uuid · nullableOptional

Indicates a fallback segment in case attribute is dimensioned and no value is added to a specific segment of that dimension

ReadOnlybooleanOptional

Indicates whether this attribute is always readonly. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

MandatorybooleanOptional

Indicates whether this attribute is always mandatory. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

Columnsinteger · int32Optional

The number of columns this attribute should span in the PIM backoffice (1-12)

UnchangeablebooleanOptional

Indicates whether this attribute cannot change its value, once it has a value assigned. NOTE: Only applied when attribute is a sub attribute of a complex attribute.

AttributeTypestring · nullableRead-onlyOptional

Type of attribute

DisableRevisionLoggingbooleanOptional

Disable all revision logging for this attribute

DisableIndexingbooleanOptional

Disable indexing for this attribute

post/v1/attributes/batch

Get references to an attribute from other attributes

get

#Available from v.3.5.0

Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Uid of attribute

Responses
200

OK

application/json

Model holding references from other entities to an attribute

AttributeUidstring · uuidOptional

Id of the referenced attribute

ReferencingCategoriesinteger · int32[] · nullableOptional

List of categories referencing this attribute for product attribute templating

ReferencingGlobalListValuesstring · uuid[] · nullableOptional

List of global list values referencing this attribute

ReferencingProductStructuresstring · uuid[] · nullableOptional

List of product structures referencing this attribute

ReferencingVariationDefinitionsstring · uuid[] · nullableOptional

List of variation definitions referencing this attribute

get/v1/attributes/{uid}/references
200

OK

Get references from other attributes to a batch of attributes

post

#Available from v.3.5.0 No more than 5000 values can be requested at a time.

Authorizations
AuthorizationstringRequired
Bodystring · uuid[]
string · uuid[]Optional
Responses
200

OK

application/json

Model holding references from other entities to an attribute

AttributeUidstring · uuidOptional

Id of the referenced attribute

ReferencingCategoriesinteger · int32[] · nullableOptional

List of categories referencing this attribute for product attribute templating

ReferencingGlobalListValuesstring · uuid[] · nullableOptional

List of global list values referencing this attribute

ReferencingProductStructuresstring · uuid[] · nullableOptional

List of product structures referencing this attribute

ReferencingVariationDefinitionsstring · uuid[] · nullableOptional

List of variation definitions referencing this attribute

post/v1/attributes/batch/references
200

OK

Last updated