API Reference
/Catalog REST API
//
Update Category
Updates an existing Category identified by its route identifier, applying only the writable fields supplied in the request body (PATCH semantics).
Requires a valid API key in the X-API-KEY header.
Culture used to interpret the localized field values supplied in the request body.
- omitted / null: tenant's default culture.
- culture-code (e.g.
en-US,es): the specified culture.
A single JSON object with the subset of writable fields to update (PATCH semantics — only the supplied fields are modified). Field names must match those published by /Categories/$metadata. Normalization rules:
- Must be a non-empty JSON object.
- A JSON array is accepted only if it contains exactly one element.
- Values are coerced to CLR primitives, nested objects and arrays.
- A date attribute is a date and time with no time zone, stored and returned as written (
"cat_date": "2026-10-21T16:22:00"). A value withZor an offset (2026-10-21T14:22:00Z) is converted to its date and time in Spain (Europe/Madrid), the time the app shows (2026-10-21T16:22:00). System dates (_creation,_modify) are set by the service.
204 No Content — Update applied. The response has no body.
- 400 Bad Request — The body cannot be written: empty, an array of more than one object, an attribute the entity does not have, one that cannot be assigned or a value the attribute does not take. Answered as a message naming why, a JSON string (
"Value: ZZ not allowed","Invalid attribute name: nope_field"). - 401 Unauthorized — Missing or invalid API key. Returned by the API gateway as
{ "message": "Unauthorized", "request_id": "d8aafa5b8f3e400b60bea0123dd33317" }. - 403 Forbidden — The API key does not have write permissions for this operation.
- 404 Not Found — Category with the given identifier does not exist.
- 500 Internal Server Error — Unexpected technical error.
Request:
PATCH /Categories(123) HTTP/1.1
X-API-KEY: your-api-key-here
Accept-Language: en-US
Content-Type: application/json
{
"cat_title": "Outdoor & Camping"
}Response:
HTTP/1.1 204 No Content- Sales Layer Catalog APIhttps://api2.saleslayer.com/catalog/Categories({categoryId})
curl -i -X PATCH \
'https://api2.saleslayer.com/catalog/Categories({categoryId})' \
-H 'Accept-Language: string' \
-H 'Content-Type: application/json' \
-H 'X-API-KEY: string'