Remove Products From Category

PUT /v2/product/category/:id/products/remove

Removes one or more products from an existing product collection and returns the updated collection. The operation validates tenant ownership, applies the change atomically, and returns the remaining items with key fields for verification.

Request Body

[
      "a12debb4-3658-4b35-aaf7-d9c8ee58b9f9" //Microsoft Surface Pro 8
  ]

Response Example

{
  "_id": "collection-id-1",
  "name": "Example Collection",
  "products": [
    {
      "_id": "product-id-101",
      "subscription": false,
      "services": [],
      "integrations": [],
      "categories": ["collection-id-1"],
      "stock": 0,
      "shop_enabled": true,
      "status": {
        "active": true,
        "deleted": false
      },
      "sku": "SKU-EX-101",
      "keys": [],
      "media": ["https://example.com/image-101.jpg"],
      "country": {
        "code": "NO",
        "_id": "country-id-1"
      },
      "currency": {
        "code": "NOK",
        "_id": "currency-id-1"
      },
      "tenant": "tenant-id-1",
      "type": 3,
      "name": "Example Keyboard A",
      "description": "",
      "integration": [],
      "reference": null,
      "resell": false,
      "msp": false,
      "group_id": "group-id-101",
      "customInputs": [],
      "created": "2025-06-19T23:17:20.610Z",
      "updated": "2025-08-05T09:26:37.994Z",
      "sales_channel": "Shop",
      "products": [
        {
          "subscription_term": 8640,
          "payment_period": 720,
          "amount": {
            "default": 1,
            "min": 0
          },
          "price": 1299.99,
          "_id": "price-id-101"
        }
      ]
    },
    {
      "_id": "product-id-202",
      "subscription": false,
      "services": [],
      "integrations": [],
      "categories": ["collection-id-1"],
      "stock": 120,
      "shop_enabled": true,
      "status": {
        "active": true,
        "deleted": false
      },
      "sku": "SKU-EX-202",
      "keys": [],
      "media": ["https://example.com/image-202.jpg"],
      "country": {
        "code": "NO",
        "_id": "country-id-2"
      },
      "currency": {
        "code": "NOK",
        "_id": "currency-id-2"
      },
      "tenant": "tenant-id-1",
      "type": 3,
      "name": "Example Keyboard B",
      "description": "",
      "integration": [],
      "reference": null,
      "resell": false,
      "msp": false,
      "group_id": "group-id-202",
      "customInputs": [],
      "created": "2025-06-19T23:17:20.614Z",
      "updated": "2025-08-29T10:51:35.232Z",
      "consumption": {
        "metadata": {}
      },
      "distributor": {
        "_id": "distributor-id-1",
        "name": "Example Distributor",
        "tenant": "tenant-id-1",
        "active": false,
        "created": "2025-06-20T08:13:21.836Z",
        "updated": "2025-06-20T08:13:21.836Z"
      },
      "ingress": "",
      "managementLink": {
        "title": "",
        "url": ""
      },
      "stock_status": "20 in rest",
      "sales_channel": "Shop",
      "products": [
        {
          "subscription_term": 8640,
          "payment_period": 720,
          "amount": {
            "default": 1,
            "min": 1
          },
          "price": 1670.54,
          "_id": "price-id-202"
        }
      ]
    }
  ]
}