Update facet configuration (Deprecated)

patch deprecated

https://ac.cnstrc.com/v1/facets/{facet_name}

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

Partially update facet configuration with specified facet_name.

🚧
The Facets API has been upgraded to v2. See the Facets and Searchabilities v2 migration guide for what's changing and how to migrate.

Path Params

facet_name

string

required

Query Params

key

string

required

length between 1 and 100

The key of the index to use.

section

string

length between 1 and 100

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

string

length between 1 and 100

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

Body Params

options

array of objects

Defaults to []

A list of facet option configurations to create and associate with this facet configuration. Default value is [] (empty list).

Options

name

string

length between 1 and 100

The facet name used to refer to the facet in your catalog. Must be unique inside the section and key.

type

string

enum

Type of facet. Use multiple to display the facet as categorical values (for example, a Brand facet with values of Under Armour, Adidas and Puma) and range to display as a numeric range. You must use range when you want to display a slider, as well as when you want to display a list of range buckets.

Allowed:

display_name

string

length ≤ 200

The name of the facet to present to end users. Default value is null, in which case the name will be presented.

sort_order

string

enum

Determines the default criterion by which options of this facet group are sorted. Must be one of relevance, value (to sort facet options alphanumerically), num_matches (to sort facet options by number of matching results). Default value is relevance. Sort can be overridden by setting the position attribute on facet options.

Allowed:

sort_descending

boolean

true if this facet group's options should be sorted in descending order, false to sort ascending. Default value is true if sort_order is relevance or num_matches and false for value. Setting sort_order: relevance will set sort_descending: true for POST, PUT, PATCH endpoints if sort_descending is not explicitly set in the request.

range_type

string

enum

Should be static if a facet is configured as range. If the facet is not configured as a range, value will be null. Default value is null.

Allowed:

range_format

string

enum

Format of range facets. Determines whether the facet is configured to display as a slider (in which case the search endpoint will return only min & max values) or as a list of buckets. boundaries for sliders, options for buckets. Default value is null.

Allowed:

range_inclusive

string

enum

Used to create inclusive buckets. For example, for a rating facet, you might want to display options like 1 and above, 2 and above, 3 and above, etc. Values can be either above (options have no upper bound), below (options have no lower bound), or null if range options should not be inclusive. Default value is null

Allowed:

range_limits

array

length between 1 and 24

Defines the cut-off points for generating static range buckets. Expects list of sorted numbers (like [10, 25, 40]). Default value is null

Range Limits

match_type

string

enum

Match types specify the behavior of filters when multiple options of the same facet (e.g: color: yellow & blue) are selected. Specifies whether the results must match all options, any of them or none.

Allowed:

position

integer

Used to slot facet groups to fixed positions. Default value is null.

hidden

boolean

Specifies whether the facet is hidden from users. Use this for facet data that you don't want shown to end users, but that isn't sensitive.

protected

boolean

Specifies whether the facet is protected from users. Setting this to true will require authentication to view the facet.

countable

boolean

Specifies whether counts for each facet option should be calculated and shown in the response. Setting this to false will skip counting these options, improving performance for facets with high cardinality.

options_limit

integer

0 to 2000

Defaults to 500

Maximum number of options of facet type multiple to return in search responses. If absent, the default limit is applied.

data

object

Dictionary with any extra facet data. Default value is {} (empty dictionary).

Responses

400

Validation Error

401

Credentials are not passed or action is forbidden.

403

The supplied token does not have the required permissions.

404

Not Found

409

Conflict

429

Rate limit breached

👋 Welcome to Constructor's new and improved documentation

200OK

201Created