Skip to main content
Version: 90.0.4

addMediaFoldersToCategory

POST 

/media-folder-categories/:categoryId/media-folders

Associates one or more MediaFolders to the category in a single call: it is the "confirm" of the "add folders from list" dialog. With selectAll = true the same filters applied to listEligibleMediaFolders are sent in the body and mediaFolderIds is ignored.

The operation is atomic: the limit of folders per category is validated before any change is applied, so that the user never ends up with a partially applied selection. The associations are not part of the folder draft: they take effect immediately and always address the published folder ids.

The response is the updated category, whose attributes.mediaFolderCount reflects the new associations.

A 400 is returned when the association would exceed the maxFoldersPerCategory general configuration parameter, or when the organization of a folder does not match the organization of the marketplace of the category.

To access the service you need at least one of the following permissions:

Permission (one of)
addMediaFoldersToCategory

Request​

Responses​

"OK". The updated MediaFolderCategory.