---
title: "Update Category Tree"
method: PUT
path: "/v1/channel/categories"
tags: ["Categories"]
---

# Update Category Tree

`PUT /v1/channel/categories`

Update Channel Category tree.

## Headers

- `Content-Encoding` 'gzip'

## Request body

- ChannelCategoryTree — Full category tree published by the channel, structured as a list of root categories with nested children.
  - `categoryList` Category[]
    - `categoryId` string, required — Channel category Id.
    - `displayName` string, required — Category display name.
    - `listingAllowed` boolean — Mark a categoryId as leaf. Only leaf categories can list offers.
    - `parentCategoryId` string — Parent category Id. If category is 0 the current category is considered as root category.

## Response `201`

Category Tree created

- CategoryTreeVersion — Version identifier returned after publishing or updating the channel category tree.
  - `categoryTreeVersion` string

## Other responses

- `400` — Bad Request
- `401` — Access forbidden, invalid or unknown Token was used.
- `500` — Unexpected Server Error

---

[API](https://skmtc.dev/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.dev/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)