---
title: "Changes to Create Permission Group"
method: POST
path: "/v1/products/{productId}/permissions"
---

# Changes to Create Permission Group

`POST /v1/products/{productId}/permissions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 16 revisions.

- **2026-08-04** `6b4d53bc1455`: 9 breaking, 3 warning, 12 info
- **2026-06-08** `fc2e575e2bd3`: 14 info
- **2025-10-09** `8b8a102e5ed1`: 63 breaking, 8 info
- **2025-05-16** `2949501eef38`: 97 info
- **2024-11-02** `5e41b01aba83`: 4 info
- **2024-05-18** `f14408c16a8c`: 4 breaking, 15 warning, 1 info

## Changes

- **2026-08-04** `6b4d53bc1455`: 9 breaking, 3 warning, 12 info
  - removed the enum value `canBypassApproves` of the request property `approvalPermissionType` (media type: application/json)
  - removed the enum value `canBypassApproves` of the request property `approvalPermissionType` (media type: text/json)
  - removed the enum value `canBypassApproves` of the request property `approvalPermissionType` (media type: application/*+json)
  - removed the enum value `canBypassApproves` of the request property `environmentApprovalPermissions/items/environmentApprovalPermissionType` (media type: application/json)
  - removed the enum value `canBypassApproves` of the request property `environmentApprovalPermissions/items/environmentApprovalPermissionType` (media type: text/json)
  - removed the enum value `canBypassApproves` of the request property `environmentApprovalPermissions/items/environmentApprovalPermissionType` (media type: application/*+json)
  - removed the enum value `canBypassApproves` of the request property `newEnvironmentApprovalPermissionType` (media type: application/json)
  - removed the enum value `canBypassApproves` of the request property `newEnvironmentApprovalPermissionType` (media type: text/json)
  - removed the enum value `canBypassApproves` of the request property `newEnvironmentApprovalPermissionType` (media type: application/*+json)
  - added the new `canBypassApproval` enum value to the `approvalPermissionType` response property for the response status `201`
  - added the new `canBypassApproval` enum value to the `environmentApprovalPermissions/items/environmentApprovalPermissionType` response property for the response status `201`
  - added the new `canBypassApproval` enum value to the `newEnvironmentApprovalPermissionType` response property for the response status `201`
  - added the new `canBypassApproval` enum value to the request property `approvalPermissionType` (media type: application/json)
  - added the new `canBypassApproval` enum value to the request property `approvalPermissionType` (media type: text/json)
  - added the new `canBypassApproval` enum value to the request property `approvalPermissionType` (media type: application/*+json)
  - added the new `canBypassApproval` enum value to the request property `environmentApprovalPermissions/items/environmentApprovalPermissionType` (media type: application/json)
  - added the new `canBypassApproval` enum value to the request property `environmentApprovalPermissions/items/environmentApprovalPermissionType` (media type: text/json)
  - added the new `canBypassApproval` enum value to the request property `environmentApprovalPermissions/items/environmentApprovalPermissionType` (media type: application/*+json)
  - added the new `canBypassApproval` enum value to the request property `newEnvironmentApprovalPermissionType` (media type: application/json)
  - added the new `canBypassApproval` enum value to the request property `newEnvironmentApprovalPermissionType` (media type: text/json)
  - added the new `canBypassApproval` enum value to the request property `newEnvironmentApprovalPermissionType` (media type: application/*+json)
  - removed the `canBypassApproves` enum value from the `approvalPermissionType` response property for the response status `201`
  - removed the `canBypassApproves` enum value from the `environmentApprovalPermissions/items/environmentApprovalPermissionType` response property for the response status `201`
  - removed the `canBypassApproves` enum value from the `newEnvironmentApprovalPermissionType` response property for the response status `201`
- **2026-06-08** `fc2e575e2bd3`: 14 info
  - added the new optional request property `approvalPermissionType` (media type: application/json)
  - added the new optional request property `approvalPermissionType` (media type: text/json)
  - added the new optional request property `approvalPermissionType` (media type: application/*+json)
  - added the new optional request property `environmentApprovalPermissions` (media type: application/json)
  - added the new optional request property `environmentApprovalPermissions` (media type: text/json)
  - added the new optional request property `environmentApprovalPermissions` (media type: application/*+json)
  - added the new optional request property `newEnvironmentApprovalPermissionType` (media type: application/json)
  - added the new optional request property `newEnvironmentApprovalPermissionType` (media type: text/json)
  - added the new optional request property `newEnvironmentApprovalPermissionType` (media type: application/*+json)
  - added the required property `approvalPermissionType` to the response with the `201` status
  - added the required property `environmentAccesses/items/approveRequired` to the response with the `201` status
  - added the required property `environmentApprovalPermissions` to the response with the `201` status
  - added the required property `newEnvironmentApprovalPermissionType` to the response with the `201` status
  - added the required property `product/approveRequired` to the response with the `201` status
- **2025-10-09** `8b8a102e5ed1`: 63 breaking, 8 info
  - the request property `canCreateOrUpdateConfig` became not nullable (media type: application/json)
  - the request property `canCreateOrUpdateConfig` became not nullable (media type: text/json)
  - the request property `canCreateOrUpdateConfig` became not nullable (media type: application/*+json)
  - the request property `canCreateOrUpdateEnvironment` became not nullable (media type: application/json)
  - the request property `canCreateOrUpdateEnvironment` became not nullable (media type: text/json)
  - the request property `canCreateOrUpdateEnvironment` became not nullable (media type: application/*+json)
  - the request property `canCreateOrUpdateSegments` became not nullable (media type: application/json)
  - the request property `canCreateOrUpdateSegments` became not nullable (media type: text/json)
  - the request property `canCreateOrUpdateSegments` became not nullable (media type: application/*+json)
  - the request property `canCreateOrUpdateSetting` became not nullable (media type: application/json)
  - the request property `canCreateOrUpdateSetting` became not nullable (media type: text/json)
  - the request property `canCreateOrUpdateSetting` became not nullable (media type: application/*+json)
  - the request property `canCreateOrUpdateTag` became not nullable (media type: application/json)
  - the request property `canCreateOrUpdateTag` became not nullable (media type: text/json)
  - the request property `canCreateOrUpdateTag` became not nullable (media type: application/*+json)
  - the request property `canDeleteConfig` became not nullable (media type: application/json)
  - the request property `canDeleteConfig` became not nullable (media type: text/json)
  - the request property `canDeleteConfig` became not nullable (media type: application/*+json)
  - the request property `canDeleteEnvironment` became not nullable (media type: application/json)
  - the request property `canDeleteEnvironment` became not nullable (media type: text/json)
  - the request property `canDeleteEnvironment` became not nullable (media type: application/*+json)
  - the request property `canDeleteSegments` became not nullable (media type: application/json)
  - the request property `canDeleteSegments` became not nullable (media type: text/json)
  - the request property `canDeleteSegments` became not nullable (media type: application/*+json)
  - the request property `canDeleteSetting` became not nullable (media type: application/json)
  - the request property `canDeleteSetting` became not nullable (media type: text/json)
  - the request property `canDeleteSetting` became not nullable (media type: application/*+json)
  - the request property `canDeleteTag` became not nullable (media type: application/json)
  - the request property `canDeleteTag` became not nullable (media type: text/json)
  - the request property `canDeleteTag` became not nullable (media type: application/*+json)
  - the request property `canDisable2FA` became not nullable (media type: application/json)
  - the request property `canDisable2FA` became not nullable (media type: text/json)
  - the request property `canDisable2FA` became not nullable (media type: application/*+json)
  - the request property `canManageIntegrations` became not nullable (media type: application/json)
  - the request property `canManageIntegrations` became not nullable (media type: text/json)
  - the request property `canManageIntegrations` became not nullable (media type: application/*+json)
  - the request property `canManageMembers` became not nullable (media type: application/json)
  - the request property `canManageMembers` became not nullable (media type: text/json)
  - the request property `canManageMembers` became not nullable (media type: application/*+json)
  - the request property `canManageProductPreferences` became not nullable (media type: application/json)
  - …31 more
- **2025-05-16** `2949501eef38`: 97 info
  - the request property `canCreateOrUpdateConfig` became nullable (media type: application/json)
  - the request property `canCreateOrUpdateConfig` became nullable (media type: text/json)
  - the request property `canCreateOrUpdateConfig` became nullable (media type: application/*+json)
  - the request property `canCreateOrUpdateEnvironment` became nullable (media type: application/json)
  - the request property `canCreateOrUpdateEnvironment` became nullable (media type: text/json)
  - the request property `canCreateOrUpdateEnvironment` became nullable (media type: application/*+json)
  - the request property `canCreateOrUpdateSegments` became nullable (media type: application/json)
  - the request property `canCreateOrUpdateSegments` became nullable (media type: text/json)
  - the request property `canCreateOrUpdateSegments` became nullable (media type: application/*+json)
  - the request property `canCreateOrUpdateSetting` became nullable (media type: application/json)
  - the request property `canCreateOrUpdateSetting` became nullable (media type: text/json)
  - the request property `canCreateOrUpdateSetting` became nullable (media type: application/*+json)
  - the request property `canCreateOrUpdateTag` became nullable (media type: application/json)
  - the request property `canCreateOrUpdateTag` became nullable (media type: text/json)
  - the request property `canCreateOrUpdateTag` became nullable (media type: application/*+json)
  - the request property `canDeleteConfig` became nullable (media type: application/json)
  - the request property `canDeleteConfig` became nullable (media type: text/json)
  - the request property `canDeleteConfig` became nullable (media type: application/*+json)
  - the request property `canDeleteEnvironment` became nullable (media type: application/json)
  - the request property `canDeleteEnvironment` became nullable (media type: text/json)
  - the request property `canDeleteEnvironment` became nullable (media type: application/*+json)
  - the request property `canDeleteSegments` became nullable (media type: application/json)
  - the request property `canDeleteSegments` became nullable (media type: text/json)
  - the request property `canDeleteSegments` became nullable (media type: application/*+json)
  - the request property `canDeleteSetting` became nullable (media type: application/json)
  - the request property `canDeleteSetting` became nullable (media type: text/json)
  - the request property `canDeleteSetting` became nullable (media type: application/*+json)
  - the request property `canDeleteTag` became nullable (media type: application/json)
  - the request property `canDeleteTag` became nullable (media type: text/json)
  - the request property `canDeleteTag` became nullable (media type: application/*+json)
  - the request property `canDisable2FA` became nullable (media type: application/json)
  - the request property `canDisable2FA` became nullable (media type: text/json)
  - the request property `canDisable2FA` became nullable (media type: application/*+json)
  - the request property `canManageIntegrations` became nullable (media type: application/json)
  - the request property `canManageIntegrations` became nullable (media type: text/json)
  - the request property `canManageIntegrations` became nullable (media type: application/*+json)
  - the request property `canManageMembers` became nullable (media type: application/json)
  - the request property `canManageMembers` became nullable (media type: text/json)
  - the request property `canManageMembers` became nullable (media type: application/*+json)
  - the request property `canManageProductPreferences` became nullable (media type: application/json)
  - …57 more
- **2024-11-02** `5e41b01aba83`: 4 info
  - added the new optional request property `canDisable2FA` (media type: application/json)
  - added the new optional request property `canDisable2FA` (media type: text/json)
  - added the new optional request property `canDisable2FA` (media type: application/*+json)
  - added the optional property `canDisable2FA` to the response with the `201` status
- **2024-05-18** `f14408c16a8c`: 4 breaking, 15 warning, 1 info
  - the `name` request property's minLength was increased from `0` to `1` (media type: application/json)
  - the `name` request property's minLength was increased from `0` to `1` (media type: text/json)
  - the `name` request property's minLength was increased from `0` to `1` (media type: application/*+json)
  - removed the media type `application/hal+json` for the response with the status `201`
  - removed the request property `environmentAccesses/items/color` (media type: application/json)
  - removed the request property `environmentAccesses/items/color` (media type: text/json)
  - removed the request property `environmentAccesses/items/color` (media type: application/*+json)
  - removed the request property `environmentAccesses/items/description` (media type: application/json)
  - removed the request property `environmentAccesses/items/description` (media type: text/json)
  - removed the request property `environmentAccesses/items/description` (media type: application/*+json)
  - removed the request property `environmentAccesses/items/name` (media type: application/json)
  - removed the request property `environmentAccesses/items/name` (media type: text/json)
  - removed the request property `environmentAccesses/items/name` (media type: application/*+json)
  - removed the request property `environmentAccesses/items/order` (media type: application/json)
  - removed the request property `environmentAccesses/items/order` (media type: text/json)
  - removed the request property `environmentAccesses/items/order` (media type: application/*+json)
  - removed the request property `environmentAccesses/items/reasonRequired` (media type: application/json)
  - removed the request property `environmentAccesses/items/reasonRequired` (media type: text/json)
  - removed the request property `environmentAccesses/items/reasonRequired` (media type: application/*+json)
  - removed the non-success response with the status `401`

---

[Operation](https://skmtc.dev/configcat/apis/configcat-public-management-api/docs/v1/products/:productId/permissions/post.md) - [API](https://skmtc.dev/configcat/apis/configcat-public-management-api.md) - [Page](https://skmtc.dev/configcat/apis/configcat-public-management-api/changes/v1/products/:productId/permissions/post)