Files

seb 1860f38640 Add delivery and supplier HTTP APIs with expanded response docs.

Wire store-backed CRUD for goods receipts and suppliers, and teach the API doc generator to expand $ref/allOf/array samples so route markdown shows full JSON shapes.

2026-08-06 05:32:48 +02:00

1.2 KiB

Raw Blame History

`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": {
    "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.2 KiB Raw Blame History

PATCH /category/{id}