Skip to main content

categoryAddProductsClusters

Attach products and clusters to a category in a single operation.

Each item can be referenced by internal identifier or by external source / source identifier pair. Items already attached to the category are reported as conflicts; the rest of the request continues to process.

Possible errors:

  • CATEGORY_NOT_FOUND: The supplied category identifier did not match any category.
  • CATEGORY_ITEM_NOT_FOUND: One of the referenced products or clusters could not be located.
  • CATEGORY_ITEM_ALREADY_EXISTS: An item is already attached to the category.
  • CATEGORY_ADD_PRODUCTS_CLUSTERS_FAILED: The bulk attachment could not be applied.
  • CATEGORY_OPERATION_INVALID: The combination of inputs violates a catalogue business rule.

AUTH: Role=[product.OWNER,product.EDITOR]

categoryAddProductsClusters(
  id: Int!
  input: CategoryAddProductsClustersInput!
): CategoryAddProductsClustersResponse!

Arguments​

categoryAddProductsClusters.id ● Int! non-null scalar​

Numeric identifier of the category to attach items to.

categoryAddProductsClusters.input ● CategoryAddProductsClustersInput! non-null input​

Lists of products and clusters to attach to the category, referenced by identifier or by external source.

Type​

CategoryAddProductsClustersResponse object​

Response for adding products and clusters to a category