--- title: "Changes to Update Preference Categories" method: POST path: "/v1/{workspace}/preference_category/" --- # Changes to Update Preference Categories `POST /v1/{workspace}/preference_category/` > Every recorded change to this operation, newest first. ## Timeline Changed in 3 of 14 revisions. - **2026-10-21** `69f49fd5da7c`: 2 info - **2026-10-16** `5f0169085547`: 5 breaking, 2 warning, 3 info - **2026-07-13** `e54dd32705e8`: 19 warning, 8 info ## Changes - **2026-10-21** `69f49fd5da7c`: 2 info - added the new optional request property `root_categories/items/sections/items/categories/items/is_commercial` - added the optional property `root_categories/items/sections/items/categories/items/is_commercial` to the response with the `201` status - **2026-10-16** `5f0169085547`: 5 breaking, 2 warning, 3 info - the request property `root_categories` became required - the request property `root_categories/items/sections/items/categories/items/default_preference` became required - the request property `root_categories/items/sections/items/categories/items/name` became required - the `root_categories` request property's minItems was increased to `3` - removed the success response with the status `200` - the `root_categories/items/sections/items/categories/items/name` request property's maxLength was set to `128` - the `root_categories/items/sections/items/name` request property's maxLength was set to `128` - the request optional property `root_categories/items/sections/items/categories/items/category` became read-only - added the new `ms_teams` enum value to the request property `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` - added the success response with the status `201` - **2026-07-13** `e54dd32705e8`: 19 warning, 8 info - added the new `androidpush` enum value to the `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` response property for the response status `200` - added the new `androidpush` enum value to the `root_categories/items/sections/items/categories/items/default_opt_in_channels/items/` response property for the response status `200` - added the new `cant_unsubscribe` enum value to the `root_categories/items/sections/items/categories/items/default_preference` response property for the response status `200` - added the new `email` enum value to the `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` response property for the response status `200` - added the new `email` enum value to the `root_categories/items/sections/items/categories/items/default_opt_in_channels/items/` response property for the response status `200` - added the new `inbox` enum value to the `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` response property for the response status `200` - added the new `inbox` enum value to the `root_categories/items/sections/items/categories/items/default_opt_in_channels/items/` response property for the response status `200` - added the new `iospush` enum value to the `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` response property for the response status `200` - added the new `iospush` enum value to the `root_categories/items/sections/items/categories/items/default_opt_in_channels/items/` response property for the response status `200` - added the new `opt_in` enum value to the `root_categories/items/sections/items/categories/items/default_preference` response property for the response status `200` - added the new `opt_out` enum value to the `root_categories/items/sections/items/categories/items/default_preference` response property for the response status `200` - added the new `slack` enum value to the `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` response property for the response status `200` - added the new `slack` enum value to the `root_categories/items/sections/items/categories/items/default_opt_in_channels/items/` response property for the response status `200` - added the new `sms` enum value to the `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` response property for the response status `200` - added the new `sms` enum value to the `root_categories/items/sections/items/categories/items/default_opt_in_channels/items/` response property for the response status `200` - added the new `webpush` enum value to the `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` response property for the response status `200` - added the new `webpush` enum value to the `root_categories/items/sections/items/categories/items/default_opt_in_channels/items/` response property for the response status `200` - added the new `whatsapp` enum value to the `root_categories/items/sections/items/categories/items/default_mandatory_channels/items/` response property for the response status `200` - added the new `whatsapp` enum value to the `root_categories/items/sections/items/categories/items/default_opt_in_channels/items/` response property for the response status `200` - added the new optional request property `root_categories/items/sections/items/categories/items/digest_schedule` - added the new optional request property `root_categories/items/sections/items/categories/items/properties` - added the optional property `root_categories/items/sections/items/categories/items/description` to the response with the `200` status - added the optional property `root_categories/items/sections/items/categories/items/digest_schedule` to the response with the `200` status - added the optional property `root_categories/items/sections/items/categories/items/properties` to the response with the `200` status - added the optional property `root_categories/items/sections/items/categories/items/tags` to the response with the `200` status - added the optional property `root_categories/items/sections/items/description` to the response with the `200` status - added the optional property `root_categories/items/sections/items/tags` to the response with the `200` status --- [Operation](https://skmtc.dev/suprsend/apis/suprsend-api/docs/v1/:workspace/preference_category/post.md) - [API](https://skmtc.dev/suprsend/apis/suprsend-api.md) - [Page](https://skmtc.dev/suprsend/apis/suprsend-api/changes/v1/:workspace/preference_category/post)