v1

latestOpenAPI 3.1.02026-07-241765501.1 MB

Facets

Create or replace facet configurations

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

Create or replace facet configurations. Replacing will overwrite all other configurations you may have defined for the facet group, resetting them to their defaults, except facet options - they will not be affected.

put/v2/facets

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

{
  "facets": [
    {
      "name": "Brand",
      "path_in_metadata": "data.brand",
      "display_name": "Brand Name",
      "sort_descending": true,
      "position": 1,
      "countable": true,
      "options_limit": 300,
      "data": {
        "key": "value"
      }
    }
  ]
}

Response

Example response

{
  "facets": [
    {
      "name": "Brand",
      "path_in_metadata": "data.brand",
      "display_name": "Brand Name",
      "sort_descending": true,
      "position": 1,
      "countable": true,
      "data": {
        "key": "value"
      }
    }
  ]
}