Skip to main content
POST
/
commerce
/
catalog
/
admin
/
facets
Error
A valid request URL is required to generate request examples
{
  "facetId": 123,
  "source": {
    "id": "<string>",
    "type": "<string>",
    "name": "<string>",
    "dataType": "<string>",
    "allowsRangeQuery": true
  },
  "facetType": "<string>",
  "order": 123,
  "categoryId": 123,
  "categoryCode": "<string>",
  "valueSortType": "<string>",
  "overrideFacetId": 123,
  "isHidden": true,
  "validity": {
    "isValid": true,
    "reasonCode": "<string>"
  },
  "rangeQueries": [
    {
      "rangeValueStart": "<unknown>",
      "rangeValueEnd": "<unknown>"
    }
  ],
  "auditInfo": {
    "updateDate": "2023-11-07T05:31:56Z",
    "createDate": "2023-11-07T05:31:56Z",
    "updateBy": "<string>",
    "createBy": "<string>"
  }
}

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme.

Query Parameters

responseFields
string

limits which fields are returned in the response body

Body

application/json

The definition of a Facet

facetId
integer<int32> | null

The unique identifier for the facet definition

source
object
facetType
string | null

The type of facet. Allowable values are: Value, RangeQuery Must be a valid value for DataType defined in FacetTypeConst.

order
integer<int32>

Used to order the display of the facets within a section

categoryId
integer<int32> | null

The category that the facet is being configured at

categoryCode
string | null

The category that the facet is being configured at

valueSortType
string | null

Determines how the facet values will be sorted in the store. Must be a valid value for DataType defined in FacetValueSortTypeConst. Allowable values are: CountAscending, CountDescending, ValuesAscending, ValuesDescending, AttributeDefinition, AttributeDefinitionDescending. The default if no value is specified will be CountDescending.

overrideFacetId
integer<int32> | null

The ID of a parent category's facet being overriden

isHidden
boolean

Indicates whether the facet is hidden for the given category

validity
object
rangeQueries
object[] | null

List of ranges if the Facet is of type Range

auditInfo
object

Response

Success

The definition of a Facet

facetId
integer<int32> | null

The unique identifier for the facet definition

source
object
facetType
string | null

The type of facet. Allowable values are: Value, RangeQuery Must be a valid value for DataType defined in FacetTypeConst.

order
integer<int32>

Used to order the display of the facets within a section

categoryId
integer<int32> | null

The category that the facet is being configured at

categoryCode
string | null

The category that the facet is being configured at

valueSortType
string | null

Determines how the facet values will be sorted in the store. Must be a valid value for DataType defined in FacetValueSortTypeConst. Allowable values are: CountAscending, CountDescending, ValuesAscending, ValuesDescending, AttributeDefinition, AttributeDefinitionDescending. The default if no value is specified will be CountDescending.

overrideFacetId
integer<int32> | null

The ID of a parent category's facet being overriden

isHidden
boolean

Indicates whether the facet is hidden for the given category

validity
object
rangeQueries
object[] | null

List of ranges if the Facet is of type Range

auditInfo
object