diff --git a/data/api/v2/full_spec.yaml b/data/api/v2/full_spec.yaml
index 9bd31c59af9..1a9bf888298 100644
--- a/data/api/v2/full_spec.yaml
+++ b/data/api/v2/full_spec.yaml
@@ -113493,7 +113493,11 @@ paths:
         permissions:
           - user_access_read
     post:
-      description: Create a new role for your organization.
+      description: >-
+        Create a new role for your organization.
+
+
+        **Note**: When a role is created, the following permissions are automatically added, regardless of whether they are 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, and CD Visibility Read.
       operationId: CreateRole
       requestBody:
         content:
diff --git a/data/api/v2/translate_actions.json b/data/api/v2/translate_actions.json
index e2fb0b8ab8d..6d84fafa1c6 100644
--- a/data/api/v2/translate_actions.json
+++ b/data/api/v2/translate_actions.json
@@ -3288,7 +3288,7 @@
     "summary": "List roles"
   },
   "CreateRole": {
-    "description": "Create a new role for your organization.",
+    "description": "Create a new role for your organization.\n\n**Note**: When a role is created, the following permissions are automatically added, regardless of whether they are 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, and CD Visibility Read.",
     "summary": "Create role",
     "request_description": "",
     "request_schema_description": "Create a role."