941 B
941 B
POST /category
Protected. Requires a valid session cookie (credentials: 'include').
Create category
Creates a category under an authorized parent.
Body (JSON)
| Field | Required | Type | Description |
|---|---|---|---|
parentId |
yes | integer | |
name |
yes | string |
{
"parentId": 1,
"name": "New category"
}
Signals
On success, emits SSE signal: category (see GET /events).
Response 201
Created
{
"category": {
"id": 1,
"parentId": 1,
"sort": 1,
"name": "…"
}
}
Errors
| Status | Description |
|---|---|
| 400 | Validation error — {"error":"…"} |
| 401 | Unauthorized — {"error":"…"} |
| 403 | Not authorized — {"error":"…"} |
| 404 | Parent not found — {"error":"…"} |
Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.