1.3 KiB
1.3 KiB
DELETE /category/{id}
Protected. Requires a valid session cookie (credentials: 'include').
Delete category
Deletes a category the user is authorized for (not the company root). When recursive=true, recursively deletes all child categories, unassigns POS terminals, and deletes articles that only exist in the deleted subtree (including their children).
Path parameters
| Param | Required | Type | Description |
|---|---|---|---|
id |
yes | integer | Category id |
Query parameters
| Param | Required | Type | Description |
|---|---|---|---|
recursive |
no | boolean | When true, recursively deletes the category subtree and articles that only exist within it. |
Signals
On success, emits SSE signals: category, articles (see GET /events).
Response 204
Deleted
No content
Errors
| Status | Description |
|---|---|
| 400 | Invalid id or cannot delete root — {"error":"…"} |
| 401 | Unauthorized — {"error":"…"} |
| 403 | Not authorized — {"error":"…"} |
| 404 | Category not found — {"error":"…"} |
| 409 | Category has articles or subcategories — {"error":"…"} |
Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.