Files
dashback/docs/api/routes/category/update.md
seb 782c49a680 Add article history by SKU and SSE update signals for live clients.
Expose getHistoryBySku as GET /article/:sku/history, and document mutation-emitted company signals via GET /events.
2026-08-05 09:54:56 +02:00

1.1 KiB

PATCH /category/{id}

Protected. Requires a valid session cookie (credentials: 'include').

Update category (rename or move)

Updates a category the user is authorized for. name renames the category (re-slugifies in the company default language). parentId moves it under a new parent (cycle/self → Invalid parent). Either name or parentId (or both) is required.

Path parameters

Param Required Type Description
id yes integer Category id

Body (JSON)

{
  "parentId": 3
}

Signals

On success, emits SSE signal: category (see GET /events).

Response 200

Updated category (renamed and/or moved)

{
  "category": { … }
}

Errors

Status Description
400 Validation error (name or parentId required, or invalid parent) — {"error":"…"}
401 Unauthorized — {"error":"…"}
403 Not authorized — {"error":"…"}
404 Category not found — {"error":"…"}

Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.