[DOCS-12652] Document permissions automatically added to new roles (#1825)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -168771,7 +168771,21 @@ paths:
         permissions:
           - user_access_read
     post:
-      description: Create a new role for your organization.
+      description: |-
+        Create a new role for your organization.
+
+        The following read permissions are automatically added to every new role, even if they are not included in the request:
+
+        - Dashboards Read
+        - Notebooks Read
+        - Monitors Read
+        - APM Read
+        - Vulnerability Management Read
+        - RUM Apps Read
+        - Incidents Read
+        - SLOs Read
+        - CI Visibility Read
+        - CD Visibility Read
       operationId: CreateRole
       requestBody:
         content:

src/datadogV2/api/api_roles.rs

@@ -763,6 +763,19 @@ impl RolesAPI {
     }
 
     /// Create a new role for your organization.
+    ///
+    /// The following read permissions are automatically added to every new role, even if they are not included in the request:
+    ///
+    /// - Dashboards Read
+    /// - Notebooks Read
+    /// - Monitors Read
+    /// - APM Read
+    /// - Vulnerability Management Read
+    /// - RUM Apps Read
+    /// - Incidents Read
+    /// - SLOs Read
+    /// - CI Visibility Read
+    /// - CD Visibility Read
     pub async fn create_role(
         &self,
         body: crate::datadogV2::model::RoleCreateRequest,
@@ -782,6 +795,19 @@ impl RolesAPI {
     }
 
     /// Create a new role for your organization.
+    ///
+    /// The following read permissions are automatically added to every new role, even if they are not included in the request:
+    ///
+    /// - Dashboards Read
+    /// - Notebooks Read
+    /// - Monitors Read
+    /// - APM Read
+    /// - Vulnerability Management Read
+    /// - RUM Apps Read
+    /// - Incidents Read
+    /// - SLOs Read
+    /// - CI Visibility Read
+    /// - CD Visibility Read
     pub async fn create_role_with_http_info(
         &self,
         body: crate::datadogV2::model::RoleCreateRequest,