v1

latestOpenAPI 3.1.02026-07-241765501.1 MB

Collections

Delete items from a collection

🔐 This endpoint requires HTTP authentication (either Basic or Bearer). For authenticating with Bearer token, required scopes are: collections(w).

Delete items from a collection. If no items are provided, all items in the given collection will be deleted. Invalid items and items that are not part of the given collection will be ignored.

delete/v1/collections/{collection_id}/items

Path parameters

collection_idstring required

Query parameters

keystring required

The key of the index to use.

Example:key_K2pX7vBnU0bgA5xp

sectionstring

The section of the index to use. Defaults to Products.

Example:Products

cstring

The ID of the client and version that the request is coming from, such as cio-js-2.90.

Example:cio-js-2.90

Request body

Example request

{
  "items": [
    {
      "id": "nike-shoes",
      "source": "manual_upload",
      "variation_ids": [
        "var-red"
      ]
    }
  ]
}

Response

Example response

{
  "items": [
    {
      "source": "manual_upload",
      "variation_ids": [
        "var-red"
      ]
    }
  ]
}