BAbagisto
Admin Catalog: Categories

Create a new category

Mirrors Bagisto admin Catalog → Categories → Create. Validates slug (unique), name, position, attributes. description required when display_mode is description_only or products_and_description. File-upload for logo_path / banner_path is NOT supported in v1.

post/catalog/categories

Request

Request body

slugstring required
namestring required
descriptionstring
positioninteger required
attributesinteger[] required
parent_idinteger nullable
display_mode'products_and_description' | 'products_only' | 'description_only'
statusinteger
localestring
meta_titlestring

Example request

{
  "slug": "apparel",
  "name": "Apparel",
  "description": "Men's and women's apparel",
  "position": 1,
  "attributes": [
    11,
    23
  ],
  "parent_id": 1,
  "display_mode": "products_and_description",
  "status": 1,
  "locale": "en",
  "meta_title": "Apparel"
}

Response

Category created. Returns the same shape as GET /catalog/categories/{id}.

Changes

No recorded changes to this operation across all 8 revisions of this API.