Skip to main content
PATCH
/
categories
/
{categoryId}
/
descriptions
/
{salesChannelId}
/
{languageIso}
Update Category Description
curl --request PATCH \
  --url https://api.jtl-cloud.com/erp/categories/{categoryId}/descriptions/{salesChannelId}/{languageIso} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-appid: <x-appid>' \
  --header 'x-appversion: <x-appversion>' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "Name": "Binoculars",
  "Description": "Best Binoculars",
  "SeoPath": "binoculars",
  "SeoMetaDescription": "Best Binoculars",
  "SeoTitleTag": "Best Binoculars",
  "SeoMetaKeywords": "Best, Binoculars"
}
'
{
  "ErrorCode": "<string>",
  "ValidationErrors": {},
  "Errors": {},
  "ErrorMessage": "<string>",
  "Stacktrace": "<string>"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

x-api-key
string
header
required

Optional: If no token is present, the API Gateway injects it.

Headers

api-version
string

Specify the desired API version, e.g. '1.0'. If not provided, the last available version is set.

x-appid
string
required

This is the name of your application, e.g. "MyApp/1.0.0". It is used to identify your application.

x-appversion
string
required

This is where the version number of your application is entered, e.g. "1.0.0".

x-runas
string

The User-Id (int or uuid) on whose behalf the request is executed. Requires scope 'Application.RunAs'.

X-SessionId
string<uuid>

The id of a session in which the call will be executed.

x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

Path Parameters

salesChannelId
string
required

The id of the sales channel that the descriptions belong to.

languageIso
string
required

The iso code of the language that the descriptions belong to.

categoryId
integer<int32>
required

Body

application/json

The category to update.

Model Class: UpdateCategoryDescription

Name
string
Example:

"Binoculars"

Description
string
Example:

"Best Binoculars"

SeoPath
string
Example:

"binoculars"

SeoMetaDescription
string
Example:

"Best Binoculars"

SeoTitleTag
string
Example:

"Best Binoculars"

SeoMetaKeywords
string
Example:

"Best, Binoculars"

Response