---
title: "Changes to Update Permission Group"
method: PUT
path: "/v1/permissions/{permissionGroupId}"
---

# Changes to Update Permission Group

`PUT /v1/permissions/{permissionGroupId}`

> 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`: 28 breaking, 16 info
- **2025-05-16** `2949501eef38`: 34 info
- **2024-11-02** `5e41b01aba83`: 4 info
- **2024-05-18** `f14408c16a8c`: 1 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/allOf[#/components/schemas/ApprovalPermissionType]/` (media type: application/json)
  - removed the enum value `canBypassApproves` of the request property `approvalPermissionType/allOf[#/components/schemas/ApprovalPermissionType]/` (media type: text/json)
  - removed the enum value `canBypassApproves` of the request property `approvalPermissionType/allOf[#/components/schemas/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/allOf[#/components/schemas/EnvironmentApprovalPermissionType]/` (media type: application/json)
  - removed the enum value `canBypassApproves` of the request property `newEnvironmentApprovalPermissionType/allOf[#/components/schemas/EnvironmentApprovalPermissionType]/` (media type: text/json)
  - removed the enum value `canBypassApproves` of the request property `newEnvironmentApprovalPermissionType/allOf[#/components/schemas/EnvironmentApprovalPermissionType]/` (media type: application/*+json)
  - added the new `canBypassApproval` enum value to the `approvalPermissionType` response property for the response status `200`
  - added the new `canBypassApproval` enum value to the `environmentApprovalPermissions/items/environmentApprovalPermissionType` response property for the response status `200`
  - added the new `canBypassApproval` enum value to the `newEnvironmentApprovalPermissionType` response property for the response status `200`
  - added the new `canBypassApproval` enum value to the request property `approvalPermissionType/allOf[#/components/schemas/ApprovalPermissionType]/` (media type: application/json)
  - added the new `canBypassApproval` enum value to the request property `approvalPermissionType/allOf[#/components/schemas/ApprovalPermissionType]/` (media type: text/json)
  - added the new `canBypassApproval` enum value to the request property `approvalPermissionType/allOf[#/components/schemas/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/allOf[#/components/schemas/EnvironmentApprovalPermissionType]/` (media type: application/json)
  - added the new `canBypassApproval` enum value to the request property `newEnvironmentApprovalPermissionType/allOf[#/components/schemas/EnvironmentApprovalPermissionType]/` (media type: text/json)
  - added the new `canBypassApproval` enum value to the request property `newEnvironmentApprovalPermissionType/allOf[#/components/schemas/EnvironmentApprovalPermissionType]/` (media type: application/*+json)
  - removed the `canBypassApproves` enum value from the `approvalPermissionType` response property for the response status `200`
  - removed the `canBypassApproves` enum value from the `environmentApprovalPermissions/items/environmentApprovalPermissionType` response property for the response status `200`
  - removed the `canBypassApproves` enum value from the `newEnvironmentApprovalPermissionType` response property for the response status `200`
- **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 `200` status
  - added the required property `environmentAccesses/items/approveRequired` to the response with the `200` status
  - added the required property `environmentApprovalPermissions` to the response with the `200` status
  - added the required property `newEnvironmentApprovalPermissionType` to the response with the `200` status
  - added the required property `product/approveRequired` to the response with the `200` status
- **2025-10-09** `8b8a102e5ed1`: 28 breaking, 16 info
  - added `#/components/schemas/AccessType` to the `accessType` request property `allOf` list (media type: application/json)
  - added `#/components/schemas/AccessType` to the `accessType` request property `allOf` list (media type: text/json)
  - added `#/components/schemas/AccessType` to the `accessType` request property `allOf` list (media type: application/*+json)
  - added `#/components/schemas/EnvironmentAccessType` to the `newEnvironmentAccessType` request property `allOf` list (media type: application/json)
  - added `#/components/schemas/EnvironmentAccessType` to the `newEnvironmentAccessType` request property `allOf` list (media type: text/json)
  - added `#/components/schemas/EnvironmentAccessType` to the `newEnvironmentAccessType` request property `allOf` list (media type: application/*+json)
  - removed the enum value `custom` of the request property `accessType` (media type: application/json)
  - removed the enum value `custom` of the request property `accessType` (media type: text/json)
  - removed the enum value `custom` of the request property `accessType` (media type: application/*+json)
  - removed the enum value `full` of the request property `accessType` (media type: application/json)
  - removed the enum value `full` of the request property `accessType` (media type: text/json)
  - removed the enum value `full` of the request property `accessType` (media type: application/*+json)
  - removed the enum value `full` of the request property `newEnvironmentAccessType` (media type: application/json)
  - removed the enum value `full` of the request property `newEnvironmentAccessType` (media type: text/json)
  - removed the enum value `full` of the request property `newEnvironmentAccessType` (media type: application/*+json)
  - removed the enum value `none` of the request property `newEnvironmentAccessType` (media type: application/json)
  - removed the enum value `none` of the request property `newEnvironmentAccessType` (media type: text/json)
  - removed the enum value `none` of the request property `newEnvironmentAccessType` (media type: application/*+json)
  - removed the enum value `readOnly` of the request property `accessType` (media type: application/json)
  - removed the enum value `readOnly` of the request property `accessType` (media type: text/json)
  - removed the enum value `readOnly` of the request property `accessType` (media type: application/*+json)
  - removed the enum value `readOnly` of the request property `newEnvironmentAccessType` (media type: application/json)
  - removed the enum value `readOnly` of the request property `newEnvironmentAccessType` (media type: text/json)
  - removed the enum value `readOnly` of the request property `newEnvironmentAccessType` (media type: application/*+json)
  - the `accessType` request property type changed from `string` to no type (media type: application/json)
  - the `accessType` request property type changed from `string` to no type (media type: application/*+json)
  - the `newEnvironmentAccessType` request property type changed from `string` to no type (media type: application/json)
  - the `newEnvironmentAccessType` request property type changed from `string` to no type (media type: application/*+json)
  - the request property `accessType` became nullable (media type: application/json)
  - the request property `accessType` became nullable (media type: text/json)
  - the request property `accessType` became nullable (media type: application/*+json)
  - the request property `newEnvironmentAccessType` became nullable (media type: application/json)
  - the request property `newEnvironmentAccessType` became nullable (media type: text/json)
  - the request property `newEnvironmentAccessType` became nullable (media type: application/*+json)
  - the `accessType` request property type was generalized from `string` to no type (media type: text/json)
  - the `newEnvironmentAccessType` request property type was generalized from `string` to no type (media type: text/json)
  - the response property `environmentAccesses/items/color` became required for the status `200`
  - the response property `environmentAccesses/items/description` became required for the status `200`
  - the response property `environmentAccesses/items/environmentAccessType` became required for the status `200`
  - the response property `environmentAccesses/items/environmentId` became required for the status `200`
  - …4 more
- **2025-05-16** `2949501eef38`: 34 info
  - the response property `accessType` became required for the status `200`
  - the response property `canCreateOrUpdateConfig` became required for the status `200`
  - the response property `canCreateOrUpdateEnvironment` became required for the status `200`
  - the response property `canCreateOrUpdateSegments` became required for the status `200`
  - the response property `canCreateOrUpdateSetting` became required for the status `200`
  - the response property `canCreateOrUpdateTag` became required for the status `200`
  - the response property `canDeleteConfig` became required for the status `200`
  - the response property `canDeleteEnvironment` became required for the status `200`
  - the response property `canDeleteSegments` became required for the status `200`
  - the response property `canDeleteSetting` became required for the status `200`
  - the response property `canDeleteTag` became required for the status `200`
  - the response property `canDisable2FA` became required for the status `200`
  - the response property `canManageIntegrations` became required for the status `200`
  - the response property `canManageMembers` became required for the status `200`
  - the response property `canManageProductPreferences` became required for the status `200`
  - the response property `canManageWebhook` became required for the status `200`
  - the response property `canRotateSdkKey` became required for the status `200`
  - the response property `canTagSetting` became required for the status `200`
  - the response property `canUseExportImport` became required for the status `200`
  - the response property `canViewProductAuditLog` became required for the status `200`
  - the response property `canViewProductStatistics` became required for the status `200`
  - the response property `canViewSdkKey` became required for the status `200`
  - the response property `environmentAccesses` became required for the status `200`
  - the response property `name` became required for the status `200`
  - the response property `newEnvironmentAccessType` became required for the status `200`
  - the response property `permissionGroupId` became required for the status `200`
  - the response property `product` became required for the status `200`
  - the response property `product/name` became required for the status `200`
  - the response property `product/order` became required for the status `200`
  - the response property `product/organization` became required for the status `200`
  - the response property `product/organization/name` became required for the status `200`
  - the response property `product/organization/organizationId` became required for the status `200`
  - the response property `product/productId` became required for the status `200`
  - the response property `product/reasonRequired` became required for the status `200`
- **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 `200` status
- **2024-05-18** `f14408c16a8c`: 1 breaking, 15 warning, 1 info
  - removed the media type `application/hal+json` for the response with the status `200`
  - 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/permissions/:permissionGroupId/put.md) - [API](https://skmtc.dev/configcat/apis/configcat-public-management-api.md) - [Page](https://skmtc.dev/configcat/apis/configcat-public-management-api/changes/v1/permissions/:permissionGroupId/put)
