`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)

Field	Required	Type	Description
`name`	no	string
`parentId`	no	integer	New parent category id

{
  "parentId": 3
}

Signals

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

Response `200`

Updated category (renamed and/or moved)

{
  "category": {
    "id": 1,
    "name": "…",
    "slug": "…",
    "parentId": 1,
    "sort": 1
  }
}

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.

1.4 KiB Raw Blame History

PATCH /category/{id}