---
title: "Changes to Updates a category"
method: PUT
path: "/categories/{id}.json"
---

# Changes to Updates a category

`PUT /categories/{id}.json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 52 revisions.

- **2026-11-13** `63c2b7699b88`: 1 info
- **2026-10-31** `655f381c1c27`: 1 info
- **2026-06-08** `4c4a6f2d6793`: 2 info
- **2026-04-27** `fdca867aa083`: 5 info
- **2026-04-03** `bfe6030ff809`: 3 info
- **2026-01-04** `9d06e60c0130`: 1 info
- **2025-10-27** `8393fa61d3e0`: 1 breaking, 4 info
- **2025-10-14** `e90da7406181`: 8 info
- **2024-04-27** `a8a8800fae2b`: 1 info
- **2024-01-27** `2df0ac845943`: 2 breaking, 1 info
- **2023-08-11** `7b91dc8ad5ad`: 3 info
- **2022-11-24** `1a99c14f514c`: 7 info
- **2022-07-15** `100ac4a61d07`: 2 breaking, 1 info
- **2022-03-05** `e1108b0434c0`: 1 info

## Changes

- **2026-11-13** `63c2b7699b88`: 1 info
  - added the required property `category/available_category_types/items/svg_icon` to the response with the `200` status
- **2026-10-31** `655f381c1c27`: 1 info
  - added the optional property `category/permission_groups` to the response with the `200` status
- **2026-06-08** `4c4a6f2d6793`: 2 info
  - added the optional property `category/available_category_types` to the response with the `200` status
  - added the optional property `category/category_type_settings` to the response with the `200` status
- **2026-04-27** `fdca867aa083`: 5 info
  - added the optional property `category/category_setting/nested_replies_default` to the response with the `200` status
  - added the optional property `category/category_setting/reply_posting_review_mode` to the response with the `200` status
  - added the optional property `category/category_setting/topic_posting_review_mode` to the response with the `200` status
  - added the required property `category/reply_posting_review_group_ids` to the response with the `200` status
  - added the required property `category/topic_posting_review_group_ids` to the response with the `200` status
- **2026-04-03** `bfe6030ff809`: 3 info
  - added the optional property `category/category_types` to the response with the `200` status
  - added the optional property `category/locale` to the response with the `200` status
  - added the required property `category/topic_title_placeholder` to the response with the `200` status
- **2026-01-04** `9d06e60c0130`: 1 info
  - added the required property `category/group_permissions/items/group_id` to the response with the `200` status
- **2025-10-27** `8393fa61d3e0`: 1 breaking, 4 info
  - the `category/category_setting` response's property type changed from no type to `object` for status `200`
  - added the optional property `category/category_setting/auto_bump_cooldown_days` to the response with the `200` status
  - added the optional property `category/category_setting/num_auto_bump_daily` to the response with the `200` status
  - added the optional property `category/category_setting/require_reply_approval` to the response with the `200` status
  - added the optional property `category/category_setting/require_topic_approval` to the response with the `200` status
- **2025-10-14** `e90da7406181`: 8 info
  - added the new optional request property `category_localizations`
  - added the new optional request property `emoji`
  - added the new optional request property `icon`
  - added the new optional request property `style_type`
  - added the optional property `category/category_localizations` to the response with the `200` status
  - added the optional property `category/emoji` to the response with the `200` status
  - added the optional property `category/icon` to the response with the `200` status
  - added the optional property `category/style_type` to the response with the `200` status
- **2024-04-27** `a8a8800fae2b`: 1 info
  - added the required property `category/subcategory_count` to the response with the `200` status
- **2024-01-27** `2df0ac845943`: 2 breaking, 1 info
  - the `category/has_children` response's property type changed from `string, null` to `boolean, null` for status `200`
  - the `category/permission` response's property type changed from `string, null` to `integer, null` for status `200`
  - added the required property `category/uploaded_background_dark` to the response with the `200` status
- **2023-08-11** `7b91dc8ad5ad`: 3 info
  - added the new optional request property `form_template_ids`
  - added the optional property `category/category_setting` to the response with the `200` status
  - added the required property `category/form_template_ids` to the response with the `200` status
- **2022-11-24** `1a99c14f514c`: 7 info
  - added the new optional request property `allow_badges`
  - added the new optional request property `parent_category_id`
  - added the new optional request property `permissions`
  - added the new optional request property `search_priority`
  - added the new optional request property `slug`
  - added the new optional request property `topic_featured_links_allowed`
  - added the required property `category/uploaded_logo_dark` to the response with the `200` status
- **2022-07-15** `100ac4a61d07`: 2 breaking, 1 info
  - removed the required property `category/min_tags_from_required_group` from the response with the `200` status
  - removed the required property `category/required_tag_group_name` from the response with the `200` status
  - added the required property `category/required_tag_groups` to the response with the `200` status
- **2022-03-05** `e1108b0434c0`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/discourse/apis/discourse-api-documentation/docs/categories/:id.json/put.md) - [API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) - [Page](https://skmtc.dev/discourse/apis/discourse-api-documentation/changes/categories/:id.json/put)