Category — Update (and Move)

Updates an existing category. Mirrors Catalog → Categories → Edit in the Bagisto admin panel.

There is no separate move endpoint. Re-parenting and reordering are part of the ordinary update payload — PUT the category with a new parent_id and position. The admin panel works the same way: both are ordinary editable fields on the category form, not a distinct "move" action.

Endpoint

Endpoint	Method
/api/admin/catalog/categories/{id}	PUT

{id} must be a positive integer.

Request body

Field	Type	Required	Notes
locale	string	no	Locale being edited (defaults to the app locale).
position	integer	yes	Display order.
attributes	integer[]	yes	List of filterable attribute ids.
parent_id	integer|null	no	New parent — supply to re-parent (move) the category.
status	integer	no	0 / 1.
<locale>	object	yes	Locale-nested translatable fields — see below.

Locale-nested translatable fields

Translatable fields go inside a key matching the locale code (e.g. "en"):

Field	Notes
slug	Required.
name	Required.
description	Required when display_mode is description_only or products_and_description.
meta_title / meta_description / meta_keywords	Optional SEO fields.

Response

200 OK. Same shape as GET /api/admin/catalog/categories/{id}.

Errors

HTTP	Cause
401 Unauthorized	Missing or invalid Bearer token
404 Not Found	The category does not exist
422 Unprocessable Entity	Locale-nested validation failure