---
title: "Changes to Create a new category"
method: POST
path: "/categories"
---

# Changes to Create a new category

`POST /categories`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-08-14** `617707efafe8`: 2 breaking, 7 info

## Changes

- **2026-08-14** `617707efafe8`: 2 breaking, 7 info
  - the `__v` response's property type changed from `integer` to `number` for status `201`
  - the `subcategories/items/__v` response's property type changed from `integer` to `number` for status `201`
  - added the new optional request property `status`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the `ACTIVE` enum value from the `status` response property for the response status `201`
  - removed the `ACTIVE` enum value from the `subcategories/items/status` response property for the response status `201`
  - removed the `ARCHIVED` enum value from the `status` response property for the response status `201`
  - removed the `INACTIVE` enum value from the `subcategories/items/status` response property for the response status `201`

---

[Operation](https://skmtc.dev/boyahq/apis/boya-categories-api/docs/categories/post.md) - [API](https://skmtc.dev/boyahq/apis/boya-categories-api.md) - [Page](https://skmtc.dev/boyahq/apis/boya-categories-api/changes/categories/post)