Extend PATCH /category/:id to also move (parentId) alongside rename.
PATCH now accepts name (rename, re-slugify) and/or parentId (move under a new parent, cycle/self guarded), merging both results. Renames the PATCH docs file to category/update.md and regenerates API docs.
This commit is contained in:
@@ -2,9 +2,13 @@
|
||||
|
||||
Protected. Requires a valid session cookie (`credentials: 'include'`).
|
||||
|
||||
Rename category
|
||||
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.
|
||||
|
||||
Renames a category the user is authorized for (updates name and re-slugifies in the company default language).
|
||||
|
||||
## Path parameters
|
||||
|
||||
@@ -16,13 +20,13 @@ Renames a category the user is authorized for (updates name and re-slugifies in
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Renamed category"
|
||||
"parentId": 3
|
||||
}
|
||||
```
|
||||
|
||||
## Response `200`
|
||||
|
||||
Renamed category
|
||||
Updated category (renamed and/or moved)
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -34,7 +38,7 @@ Renamed category
|
||||
|
||||
| Status | Description |
|
||||
|--------|-------------|
|
||||
| 400 | Validation error (name required) — `{"error":"…"}` |
|
||||
| 400 | Validation error (name or parentId required, or invalid parent) — `{"error":"…"}` |
|
||||
| 401 | Unauthorized — `{"error":"…"}` |
|
||||
| 403 | Not authorized — `{"error":"…"}` |
|
||||
| 404 | Category not found — `{"error":"…"}` |
|
||||
Reference in New Issue
Block a user