Skip to main content

categoryRemoveProductsClusters

Remove products and clusters from a category.

Disassociates individual products and/or clusters from the specified category, removing them from the category's product organization. This operation updates the category's product associations immediately.

Possible errors:

  • CATEGORY_NOT_FOUND_ERROR: Category with the specified ID does not exist
  • PRODUCT_NOT_FOUND_ERROR: One or more specified products do not exist
  • CATEGORY_REMOVE_PRODUCTS_CLUSTERS_ERROR: Failed to remove products/clusters from category
  • MISSING_ARGUMENT_ERROR: Neither productIds nor clusterIds provided
  • UNAUTHENTICATED: Invalid or missing authentication
  • FORBIDDEN: Insufficient permissions to modify categories

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

categoryRemoveProductsClusters(
id: Int!
input: CategoryRemoveProductsClustersInput!
): CategoryRemoveProductsClustersResponse!

Arguments

categoryRemoveProductsClusters.id ● Int! non-null scalar

Unique identifier of the category to modify.

Must be a positive integer representing a valid category ID in the system.

categoryRemoveProductsClusters.input ● CategoryRemoveProductsClustersInput! non-null input

Products and clusters to remove from the category.

Contains arrays of product IDs and/or cluster IDs to disassociate from the category. At least one array must be provided.

Type

CategoryRemoveProductsClustersResponse object