Document permissions omission and empty list distinction for Update a Role API

.generator/schemas/v2/openapi.yaml

@@ -216523,6 +216523,11 @@ paths:
         [Restricted permissions](https://docs.datadoghq.com/account_management/rbac/permissions/#restricted-permissions),
         such as Dashboards Read and Monitors Read, remain on the role by default, even if they are omitted from
         the request. To exclude them, set `default_permissions_opt_out` to `true`.
+
+        Omitting the `permissions` relationship from the request leaves the role's existing permissions
+        unchanged. Sending `"permissions": {"data": []}` removes all permissions except restricted default
+        permissions, which remain unless `default_permissions_opt_out` is `true`. Some restricted permissions
+        can only be excluded after Minimal Access Roles is enabled for the organization.
       operationId: UpdateRole
       parameters:
         - $ref: "#/components/parameters/RoleID"

src/datadog_api_client/v2/api/roles_api.py

@@ -727,6 +727,11 @@ def update_role(
         such as Dashboards Read and Monitors Read, remain on the role by default, even if they are omitted from
         the request. To exclude them, set ``default_permissions_opt_out`` to ``true``.
 
+        Omitting the ``permissions`` relationship from the request leaves the role's existing permissions
+        unchanged. Sending ``"permissions": {"data": []}`` removes all permissions except restricted default
+        permissions, which remain unless ``default_permissions_opt_out`` is ``true``. Some restricted permissions
+        can only be excluded after Minimal Access Roles is enabled for the organization.
+
         :param role_id: The unique identifier of the role.
         :type role_id: str
         :type body: RoleUpdateRequest