Update Category

Modifies a category such as moving it to another location in the category tree, or changing whether it is visible on the storefront. This PUT replaces the existing resource, so be sure to include all the information that you want to maintain for the category. Any unspecified properties are set to null.<br><br>This current version of the Categories API includes localizedContent to support <a href="/pages/catalog-structure#multi-locale-catalogs">multi-locale catalogs</a>, which was not present in the previous API model. If you were a client prior to May 2024 and have upgraded your implementation to support this feature, you can still access category data that has not yet been rewritten to the new model by providing an x-api-version header set to "1".

PUT

commerce

catalog

admin

categories

{categoryId}

Error

A valid request URL is required to generate request examples

{
  "activeDateEnd": "2023-11-07T05:31:56Z",
  "activeDateStart": "2023-11-07T05:31:56Z",
  "attributes": [
    {
      "attributeDefinitionId": 123,
      "fullyQualifiedName": "<string>",
      "values": [
        "<unknown>"
      ]
    }
  ],
  "auditInfo": {
    "createBy": "<string>",
    "createDate": "2023-11-07T05:31:56Z",
    "updateBy": "<string>",
    "updateDate": "2023-11-07T05:31:56Z"
  },
  "catalogId": 123,
  "categoryCode": "<string>",
  "categoryType": "<string>",
  "childCount": 123,
  "content": {
    "categoryImages": [
      {
        "altText": "<string>",
        "cmsId": "<string>",
        "id": 123,
        "imageLabel": "<string>",
        "imageUrl": "<string>",
        "localeCode": "<string>",
        "mediaType": "<string>",
        "sequence": 123,
        "videoUrl": "<string>"
      }
    ],
    "description": "<string>",
    "localeCode": "<string>",
    "metaTagDescription": "<string>",
    "metaTagKeywords": "<string>",
    "metaTagTitle": "<string>",
    "name": "<string>",
    "pageTitle": "<string>",
    "slug": "<string>"
  },
  "dynamicExpression": {
    "text": "<string>",
    "tree": {
      "left": "<string>",
      "logicalOperator": "<string>",
      "nodes": "<array>",
      "operator": "<string>",
      "right": "<unknown>",
      "type": "<string>"
    }
  },
  "id": 123,
  "isActive": true,
  "isDisplayed": true,
  "localizedContent": [
    {
      "categoryImages": [
        {
          "altText": "<string>",
          "cmsId": "<string>",
          "id": 123,
          "imageLabel": "<string>",
          "imageUrl": "<string>",
          "localeCode": "<string>",
          "mediaType": "<string>",
          "sequence": 123,
          "videoUrl": "<string>"
        }
      ],
      "description": "<string>",
      "localeCode": "<string>",
      "metaTagDescription": "<string>",
      "metaTagKeywords": "<string>",
      "metaTagTitle": "<string>",
      "name": "<string>",
      "pageTitle": "<string>",
      "slug": "<string>"
    }
  ],
  "parentCategoryCode": "<string>",
  "parentCategoryId": 123,
  "parentCategoryName": "<string>",
  "parentIsActive": true,
  "productCount": 123,
  "sequence": 123,
  "shouldSlice": true
}

Authorizations

Authorization

string

header

required

JWT Authorization header using the Bearer scheme.

Path Parameters

categoryId

integer<int32>

required

Unique identifier of the category that you want to modify. Required.

Query Parameters

cascadeVisibility

boolean

default:false

If true, when changing the display option for the category, change it for all subcategories also. Optional.

responseFields

string

limits which fields are returned in the response body

Body

application/json

Properties of the category that you want to modify. Required properties ParentCategoryID and Content.Name.

Category

activeDateEnd

string<date-time> | null

Active end Date

activeDateStart

string<date-time> | null

Active Start Date

attributes

object[] | null

List of attributes for the category.

Show child attributes

auditInfo

object

Show child attributes

catalogId

integer<int32> | null

The CatalogId that the category belongs to.

categoryCode

string | null

External unique identifier of the category.

categoryType

string | null

The Type of Category Static, Dyanmic, DynamicPreComputed

childCount

integer<int32> | null

Number of subcategories that belong to this category. These subcategories are at the same level (siblings).

content

object

Container for language-specific content to display on the storefront. You'll have a container for each supported language (LocaleCode). This enables you to display a category in multiple languages yet manage it as a single category internally.

Show child attributes

dynamicExpression

object

Category

Show child attributes

integer<int32> | null

Internal unique identifier of the category. System-supplied and read-only.

isActive

boolean | null

If false, the category is considered unavailable in runtime (default is true if not specified on create)

isDisplayed

boolean | null

If true, the category appears to shoppers on the storefront.

localizedContent

object[] | null

Show child attributes

parentCategoryCode

string | null

parentCategoryId

integer<int32> | null

Unique identifier of the category to which this category belongs. If nil, this is a top-level category. System-supplied and read-only.

parentCategoryName

string | null

parentIsActive

boolean | null

productCount

integer<int32> | null

Number of products contained in this category. This count includes all products contained in any subcategories of this category.

sequence

integer<int32> | null

Order in which categories appear when they are at the same level (siblings). For example, you could change the sequence of categories so that a specific category always appears first.

shouldSlice

boolean | null

If True, search displays sliced view

Response

Category

activeDateEnd

string<date-time> | null

Active end Date

activeDateStart

string<date-time> | null

Active Start Date

attributes

object[] | null

List of attributes for the category.

Show child attributes

auditInfo

object

Show child attributes

catalogId

integer<int32> | null

The CatalogId that the category belongs to.

categoryCode

string | null

External unique identifier of the category.

categoryType

string | null

The Type of Category Static, Dyanmic, DynamicPreComputed

childCount

integer<int32> | null

Number of subcategories that belong to this category. These subcategories are at the same level (siblings).

content

object

Show child attributes

dynamicExpression

object

Category

Show child attributes

integer<int32> | null

Internal unique identifier of the category. System-supplied and read-only.

isActive

boolean | null

If false, the category is considered unavailable in runtime (default is true if not specified on create)

isDisplayed

boolean | null

If true, the category appears to shoppers on the storefront.

localizedContent

object[] | null

Show child attributes

parentCategoryCode

string | null

parentCategoryId

integer<int32> | null

Unique identifier of the category to which this category belongs. If nil, this is a top-level category. System-supplied and read-only.

parentCategoryName

string | null

parentIsActive

boolean | null

productCount

integer<int32> | null

Number of products contained in this category. This count includes all products contained in any subcategories of this category.

sequence

integer<int32> | null

Order in which categories appear when they are at the same level (siblings). For example, you could change the sequence of categories so that a specific category always appears first.

shouldSlice

boolean | null

If True, search displays sliced view

Error

A valid request URL is required to generate request examples

{
  "activeDateEnd": "2023-11-07T05:31:56Z",
  "activeDateStart": "2023-11-07T05:31:56Z",
  "attributes": [
    {
      "attributeDefinitionId": 123,
      "fullyQualifiedName": "<string>",
      "values": [
        "<unknown>"
      ]
    }
  ],
  "auditInfo": {
    "createBy": "<string>",
    "createDate": "2023-11-07T05:31:56Z",
    "updateBy": "<string>",
    "updateDate": "2023-11-07T05:31:56Z"
  },
  "catalogId": 123,
  "categoryCode": "<string>",
  "categoryType": "<string>",
  "childCount": 123,
  "content": {
    "categoryImages": [
      {
        "altText": "<string>",
        "cmsId": "<string>",
        "id": 123,
        "imageLabel": "<string>",
        "imageUrl": "<string>",
        "localeCode": "<string>",
        "mediaType": "<string>",
        "sequence": 123,
        "videoUrl": "<string>"
      }
    ],
    "description": "<string>",
    "localeCode": "<string>",
    "metaTagDescription": "<string>",
    "metaTagKeywords": "<string>",
    "metaTagTitle": "<string>",
    "name": "<string>",
    "pageTitle": "<string>",
    "slug": "<string>"
  },
  "dynamicExpression": {
    "text": "<string>",
    "tree": {
      "left": "<string>",
      "logicalOperator": "<string>",
      "nodes": "<array>",
      "operator": "<string>",
      "right": "<unknown>",
      "type": "<string>"
    }
  },
  "id": 123,
  "isActive": true,
  "isDisplayed": true,
  "localizedContent": [
    {
      "categoryImages": [
        {
          "altText": "<string>",
          "cmsId": "<string>",
          "id": 123,
          "imageLabel": "<string>",
          "imageUrl": "<string>",
          "localeCode": "<string>",
          "mediaType": "<string>",
          "sequence": 123,
          "videoUrl": "<string>"
        }
      ],
      "description": "<string>",
      "localeCode": "<string>",
      "metaTagDescription": "<string>",
      "metaTagKeywords": "<string>",
      "metaTagTitle": "<string>",
      "name": "<string>",
      "pageTitle": "<string>",
      "slug": "<string>"
    }
  ],
  "parentCategoryCode": "<string>",
  "parentCategoryId": 123,
  "parentCategoryName": "<string>",
  "parentIsActive": true,
  "productCount": 123,
  "sequence": 123,
  "shouldSlice": true
}

Developers

API reference

AI Tools

Update Category

Authorizations

Path Parameters

Query Parameters

Body

Response