GlobalLists

Global lists define reusable object structures that can be referenced on products, variants, categories or within global lists themselves. A global list uses an attribute to define the data model for values in the global list. Using Complex attributes as the data model allows for complex value models for each global list value object.

Get all global lists created in the system

get
Authorizations
AuthorizationstringRequired
Responses
200

OK

application/json
get
/v1/GlobalLists
200

OK

Create a new global list

post
Authorizations
AuthorizationstringRequired
Body

Global list represents a global collection of reusable objects

Idinteger · int32Optional

Id of global list (readonly)

Uidstring · uuidOptional

Unique id of global list

ViewRequiresPermissionbooleanOptional

Indicates whether a special permission is required to view the global list

ViewPermissionstring · uuid | nullableOptional

Permission required to view the global list, if ViewRequiresPermission is set

CreateRequiresPermissionbooleanOptional

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermissionbooleanOptional

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermissionbooleanOptional

Indicates whether a special permission is required in order to delete values in the global list

CreatePermissionstring · uuid | nullableOptional

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermissionstring · uuid | nullableOptional

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermissionstring · uuid | nullableOptional

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUidstring · uuid | nullableOptional

Uid of folder to place global list in

RequiresSortingbooleanOptional

Defines if values on a global list values should be sorted on creation

GlobalListKeysstring[] | nullableOptional

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitivebooleanOptional

Defines if key value for a global list value is case insensitive

Responses
post
/v1/GlobalLists

Update a global list

put
Authorizations
AuthorizationstringRequired
Body

Global list represents a global collection of reusable objects

Idinteger · int32Optional

Id of global list (readonly)

Uidstring · uuidOptional

Unique id of global list

ViewRequiresPermissionbooleanOptional

Indicates whether a special permission is required to view the global list

ViewPermissionstring · uuid | nullableOptional

Permission required to view the global list, if ViewRequiresPermission is set

CreateRequiresPermissionbooleanOptional

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermissionbooleanOptional

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermissionbooleanOptional

Indicates whether a special permission is required in order to delete values in the global list

CreatePermissionstring · uuid | nullableOptional

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermissionstring · uuid | nullableOptional

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermissionstring · uuid | nullableOptional

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUidstring · uuid | nullableOptional

Uid of folder to place global list in

RequiresSortingbooleanOptional

Defines if values on a global list values should be sorted on creation

GlobalListKeysstring[] | nullableOptional

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitivebooleanOptional

Defines if key value for a global list value is case insensitive

Responses
200

OK

No content

put
/v1/GlobalLists
200

OK

No content

Delete a global list

delete
Authorizations
AuthorizationstringRequired
Query parameters
uidstring · uuidOptional

the Unique id of the global list

Responses
200

OK

No content

delete
/v1/GlobalLists
200

OK

No content

Get a specific global list

get
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Unique id of global list

Responses
200

OK

application/json
get
/v1/GlobalLists/{uid}
200

OK

Get a specific global list by its alias

get
Authorizations
AuthorizationstringRequired
Path parameters
aliasstringRequired

Alias of the global list to return

Responses
200

OK

application/json
get
/v1/GlobalLists/ByAlias/{alias}
200

OK

Get a batch of global lists by their aliases

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

OK

application/json
post
/v1/GlobalLists/ByAlias/batch
200

OK

Get a batch of global lists

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

OK

application/json
post
/v1/GlobalLists/batch
200

OK

Get all global list folders in the system

get
Authorizations
AuthorizationstringRequired
Responses
200

OK

application/json
get
/v1/GlobalLists/folders
200

OK

Create new global list folder

post
Authorizations
AuthorizationstringRequired
Body

Folder holding global lists

Uidstring · uuidOptional

Unique id of folder

Namestring | nullableOptional

Presented name of folder in backoffice

Responses
200

OK

application/json
post
/v1/GlobalLists/folders

Update existing global list folder

put
Authorizations
AuthorizationstringRequired
Body

Folder holding global lists

Uidstring · uuidOptional

Unique id of folder

Namestring | nullableOptional

Presented name of folder in backoffice

Responses
200

OK

No content

put
/v1/GlobalLists/folders

No content

Deletes the global list folder with the specified uid

delete
Authorizations
AuthorizationstringRequired
Query parameters
uidstring · uuidOptional

Uid of folder to delete

Responses
200

OK

No content

delete
/v1/GlobalLists/folders
200

OK

No content

Get a specific global list folder

get
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Unique id of folder

Responses
200

OK

application/json
get
/v1/GlobalLists/folders/{uid}
200

OK

Get values for a specific global list

get
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Unique id of global list to get values for

Query parameters
limitinteger · int32Optional

Max number of items to return

Default: 1000000
afterIdstring · uuidOptional

Only get values sorted after this id

globalListValueReferencesOnlybooleanOptional

Indicate if only uids of referenced to global list values shall be returned instead of the materialized values

Default: false
Responses
200

OK

application/json
get
/v1/GlobalLists/{uid}/values
200

OK

Create values in a global list

post
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Unique id of global list to create values in

Bodyobject[]

Global list value object representing data on a specific object in a global list. The data type of the value property differs depending on the underlying attribute on the global list of this value.

Uidstring · uuidOptional

Unique id of global list value

SortOrderinteger · int32 | nullableOptional

Sort order of this value compared to other values in the same global list

Valueany | nullableOptional

The value dynamic value model. The data type of this model depends on the Global list attribute setup. If the global list attribute is a Text attribute, this value will be a string If it is a Number attribute, this value will be a decimal and so on.

Responses
200

OK

No content

post
/v1/GlobalLists/{uid}/values
200

OK

No content

Update values in a global list

put
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Unique id of global list to update values in

Bodyobject[]

Global list value object representing data on a specific object in a global list. The data type of the value property differs depending on the underlying attribute on the global list of this value.

Uidstring · uuidOptional

Unique id of global list value

SortOrderinteger · int32 | nullableOptional

Sort order of this value compared to other values in the same global list

Valueany | nullableOptional

The value dynamic value model. The data type of this model depends on the Global list attribute setup. If the global list attribute is a Text attribute, this value will be a string If it is a Number attribute, this value will be a decimal and so on.

Responses
200

OK

No content

put
/v1/GlobalLists/{uid}/values
200

OK

No content

Get a global list value

get
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Unique id of global list value

Query parameters
globalListValueReferencesOnlybooleanOptional

Indicate if only uids of referenced to global list values shall be returned instead of the materialized values

Default: false
Responses
200

OK

application/json
get
/v1/GlobalLists/values/{uid}

Get references to a global list value

get

#Available from v.3.5.0

Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Unique id of global list value

Responses
200

OK

application/json
get
/v1/GlobalLists/values/{uid}/references
200

OK

Get references to a batch of global list values

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
post
/v1/GlobalLists/values/batch/references
200

OK

Get a batch of global list values

post

No more than 5000 values can be requested at a time.

Authorizations
AuthorizationstringRequired
Query parameters
globalListValueReferencesOnlybooleanOptional

Indicate if only uids of referenced to global list values shall be returned instead of the materialized values

Default: false
Bodystring · uuid[]
string · uuid[]Optional
Responses
200

OK

application/json
post
/v1/GlobalLists/values/batch

Delete a range of global list values

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

OK

No content

delete
/v1/GlobalLists/values
200

OK

No content

Get uids of global list values matching certain criteria

post
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Uid of global list to search

Body

Definition of general query model

BooleanOperatorinteger · enumOptional

Boolean operator

  • 0 = And: All conditions must be met
  • 1 = Or: At least one condition must be met
Possible values:
QueryModelTypestring | nullableRead-onlyOptional

The type of query model. Name matches exact name of concrete model implementation

Responses
200

OK

application/json
Responsestring · uuid[]
post
/v1/GlobalLists/search/{uid}
200

OK

Get available query fields for a specific global list

get
Authorizations
AuthorizationstringRequired
Path parameters
uidstring · uuidRequired

Uid of global list

Responses
200

OK

application/json
get
/v1/GlobalLists/queryablefields/{uid}
200

OK

Last updated