Skip to main content
PUT
/
v1
/
channel
/
categories
Update Category Tree
curl --request PUT \
  --url https://scx-sbx.api.jtl-software.com/v1/channel/categories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "categoryList": [
    {
      "categoryId": "4711",
      "displayName": "Beer",
      "listingAllowed": true,
      "parentCategoryId": "2343"
    }
  ]
}
'
{
  "categoryTreeVersion": "1559721549-ajifn"
}

Authorizations

​
Authorization
string
header
required

As a Channel Integrator you will receive a API Refresh Token. With such a Refresh Token you need to request an Access Token with a limited Lifetime (see POST /v1/auth). This Access Token must be provided as a Bearer Token in the Authorization Header with every request.

Headers

​
Content-Encoding
enum<string>

Use the Content-Encoding: gzip when sending JSON requestBody as compressed payload. This is recommended when creating huge category trees. There is a limit of 32 MB on this route.

Available options:
gzip

Body

application/json

Full marketplace category tree to be published for use in seller listings.

Full category tree published by the channel, structured as a list of root categories with nested children.

​
categoryList
object[]
Minimum array length: 1

Response

Category Tree created

Version identifier returned after publishing or updating the channel category tree.

​
categoryTreeVersion
string
Example:

"1559721549-ajifn"