diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.json b/descriptions/api.github.com/api.github.com.2022-11-28.json
index 0f1d27e25f..6abb5184a8 100644
--- a/descriptions/api.github.com/api.github.com.2022-11-28.json
+++ b/descriptions/api.github.com/api.github.com.2022-11-28.json
@@ -64548,7 +64548,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.yaml b/descriptions/api.github.com/api.github.com.2022-11-28.yaml
index 089991031a..41040f60c9 100644
--- a/descriptions/api.github.com/api.github.com.2022-11-28.yaml
+++ b/descriptions/api.github.com/api.github.com.2022-11-28.yaml
@@ -46861,7 +46861,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/api.github.com/api.github.com.json b/descriptions/api.github.com/api.github.com.json
index 0f1d27e25f..6abb5184a8 100644
--- a/descriptions/api.github.com/api.github.com.json
+++ b/descriptions/api.github.com/api.github.com.json
@@ -64548,7 +64548,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/api.github.com/api.github.com.yaml b/descriptions/api.github.com/api.github.com.yaml
index 089991031a..41040f60c9 100644
--- a/descriptions/api.github.com/api.github.com.yaml
+++ b/descriptions/api.github.com/api.github.com.yaml
@@ -46861,7 +46861,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
index 0cc36be930..6ea23054f1 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
+++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
@@ -482569,7 +482569,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
index 4126f01be8..f2c3e1a6ea 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
+++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
@@ -93618,7 +93618,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.deref.json
index 0cc36be930..6ea23054f1 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.deref.json
+++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.json
@@ -482569,7 +482569,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
index 4126f01be8..f2c3e1a6ea 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
+++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
@@ -93618,7 +93618,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json
index a133df34f0..7bee1ba446 100644
--- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json
+++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json
@@ -510347,7 +510347,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml
index babf963e48..5b468f9e80 100644
--- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml
+++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml
@@ -100972,7 +100972,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghec/dereferenced/ghec.deref.json b/descriptions/ghec/dereferenced/ghec.deref.json
index a133df34f0..7bee1ba446 100644
--- a/descriptions/ghec/dereferenced/ghec.deref.json
+++ b/descriptions/ghec/dereferenced/ghec.deref.json
@@ -510347,7 +510347,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghec/dereferenced/ghec.deref.yaml b/descriptions/ghec/dereferenced/ghec.deref.yaml
index babf963e48..5b468f9e80 100644
--- a/descriptions/ghec/dereferenced/ghec.deref.yaml
+++ b/descriptions/ghec/dereferenced/ghec.deref.yaml
@@ -100972,7 +100972,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghec/ghec.2022-11-28.json b/descriptions/ghec/ghec.2022-11-28.json
index 10843ae792..f33e6f3fe3 100644
--- a/descriptions/ghec/ghec.2022-11-28.json
+++ b/descriptions/ghec/ghec.2022-11-28.json
@@ -71275,7 +71275,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghec/ghec.2022-11-28.yaml b/descriptions/ghec/ghec.2022-11-28.yaml
index b008ddcef4..a3ed827671 100644
--- a/descriptions/ghec/ghec.2022-11-28.yaml
+++ b/descriptions/ghec/ghec.2022-11-28.yaml
@@ -51805,7 +51805,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghec/ghec.json b/descriptions/ghec/ghec.json
index 10843ae792..f33e6f3fe3 100644
--- a/descriptions/ghec/ghec.json
+++ b/descriptions/ghec/ghec.json
@@ -71275,7 +71275,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghec/ghec.yaml b/descriptions/ghec/ghec.yaml
index b008ddcef4..a3ed827671 100644
--- a/descriptions/ghec/ghec.yaml
+++ b/descriptions/ghec/ghec.yaml
@@ -51805,7 +51805,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghes-3.10/dereferenced/ghes-3.10.2022-11-28.deref.json b/descriptions/ghes-3.10/dereferenced/ghes-3.10.2022-11-28.deref.json
index 315938f0e3..0bfbd2b2cc 100644
--- a/descriptions/ghes-3.10/dereferenced/ghes-3.10.2022-11-28.deref.json
+++ b/descriptions/ghes-3.10/dereferenced/ghes-3.10.2022-11-28.deref.json
@@ -411143,7 +411143,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghes-3.10/dereferenced/ghes-3.10.2022-11-28.deref.yaml b/descriptions/ghes-3.10/dereferenced/ghes-3.10.2022-11-28.deref.yaml
index 2ba4d31fb3..1db3216eb7 100644
--- a/descriptions/ghes-3.10/dereferenced/ghes-3.10.2022-11-28.deref.yaml
+++ b/descriptions/ghes-3.10/dereferenced/ghes-3.10.2022-11-28.deref.yaml
@@ -83972,7 +83972,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghes-3.10/dereferenced/ghes-3.10.deref.json b/descriptions/ghes-3.10/dereferenced/ghes-3.10.deref.json
index 315938f0e3..0bfbd2b2cc 100644
--- a/descriptions/ghes-3.10/dereferenced/ghes-3.10.deref.json
+++ b/descriptions/ghes-3.10/dereferenced/ghes-3.10.deref.json
@@ -411143,7 +411143,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghes-3.10/dereferenced/ghes-3.10.deref.yaml b/descriptions/ghes-3.10/dereferenced/ghes-3.10.deref.yaml
index 2ba4d31fb3..1db3216eb7 100644
--- a/descriptions/ghes-3.10/dereferenced/ghes-3.10.deref.yaml
+++ b/descriptions/ghes-3.10/dereferenced/ghes-3.10.deref.yaml
@@ -83972,7 +83972,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghes-3.10/ghes-3.10.2022-11-28.json b/descriptions/ghes-3.10/ghes-3.10.2022-11-28.json
index 6f599f1d12..05664a8a9d 100644
--- a/descriptions/ghes-3.10/ghes-3.10.2022-11-28.json
+++ b/descriptions/ghes-3.10/ghes-3.10.2022-11-28.json
@@ -60216,7 +60216,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghes-3.10/ghes-3.10.2022-11-28.yaml b/descriptions/ghes-3.10/ghes-3.10.2022-11-28.yaml
index 5a88256271..be448d754d 100644
--- a/descriptions/ghes-3.10/ghes-3.10.2022-11-28.yaml
+++ b/descriptions/ghes-3.10/ghes-3.10.2022-11-28.yaml
@@ -43580,7 +43580,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghes-3.10/ghes-3.10.json b/descriptions/ghes-3.10/ghes-3.10.json
index 6f599f1d12..05664a8a9d 100644
--- a/descriptions/ghes-3.10/ghes-3.10.json
+++ b/descriptions/ghes-3.10/ghes-3.10.json
@@ -60216,7 +60216,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghes-3.10/ghes-3.10.yaml b/descriptions/ghes-3.10/ghes-3.10.yaml
index 5a88256271..be448d754d 100644
--- a/descriptions/ghes-3.10/ghes-3.10.yaml
+++ b/descriptions/ghes-3.10/ghes-3.10.yaml
@@ -43580,7 +43580,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghes-3.11/dereferenced/ghes-3.11.2022-11-28.deref.json b/descriptions/ghes-3.11/dereferenced/ghes-3.11.2022-11-28.deref.json
index 15242a76b9..1429438de8 100644
--- a/descriptions/ghes-3.11/dereferenced/ghes-3.11.2022-11-28.deref.json
+++ b/descriptions/ghes-3.11/dereferenced/ghes-3.11.2022-11-28.deref.json
@@ -425674,7 +425674,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghes-3.11/dereferenced/ghes-3.11.2022-11-28.deref.yaml b/descriptions/ghes-3.11/dereferenced/ghes-3.11.2022-11-28.deref.yaml
index 4160d54613..83f32452d7 100644
--- a/descriptions/ghes-3.11/dereferenced/ghes-3.11.2022-11-28.deref.yaml
+++ b/descriptions/ghes-3.11/dereferenced/ghes-3.11.2022-11-28.deref.yaml
@@ -86362,7 +86362,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghes-3.11/dereferenced/ghes-3.11.deref.json b/descriptions/ghes-3.11/dereferenced/ghes-3.11.deref.json
index 15242a76b9..1429438de8 100644
--- a/descriptions/ghes-3.11/dereferenced/ghes-3.11.deref.json
+++ b/descriptions/ghes-3.11/dereferenced/ghes-3.11.deref.json
@@ -425674,7 +425674,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghes-3.11/dereferenced/ghes-3.11.deref.yaml b/descriptions/ghes-3.11/dereferenced/ghes-3.11.deref.yaml
index 4160d54613..83f32452d7 100644
--- a/descriptions/ghes-3.11/dereferenced/ghes-3.11.deref.yaml
+++ b/descriptions/ghes-3.11/dereferenced/ghes-3.11.deref.yaml
@@ -86362,7 +86362,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghes-3.11/ghes-3.11.2022-11-28.json b/descriptions/ghes-3.11/ghes-3.11.2022-11-28.json
index fbc0ab8caf..3211cf17f6 100644
--- a/descriptions/ghes-3.11/ghes-3.11.2022-11-28.json
+++ b/descriptions/ghes-3.11/ghes-3.11.2022-11-28.json
@@ -61696,7 +61696,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permissions (read).\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
         "tags": [
           "activity"
         ],
diff --git a/descriptions/ghes-3.11/ghes-3.11.2022-11-28.yaml b/descriptions/ghes-3.11/ghes-3.11.2022-11-28.yaml
index 3b71a7dd9c..3d949b2aef 100644
--- a/descriptions/ghes-3.11/ghes-3.11.2022-11-28.yaml
+++ b/descriptions/ghes-3.11/ghes-3.11.2022-11-28.yaml
@@ -44591,7 +44591,7 @@ paths:
     get:
       summary: List events for the authenticated user
       description: |-
-        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+        If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
 
         > [!NOTE]
         > This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.
diff --git a/descriptions/ghes-3.11/ghes-3.11.json b/descriptions/ghes-3.11/ghes-3.11.json
index fbc0ab8caf..3211cf17f6 100644
--- a/descriptions/ghes-3.11/ghes-3.11.json
+++ b/descriptions/ghes-3.11/ghes-3.11.json
@@ -61696,7 +61696,7 @@
     "/users/{username}/events": {
       "get": {
         "summary": "List events for the authenticated user",
-        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.\n\n> [!NOTE]\n> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.",
+        "description": "If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. _Optional_: use the fine-grained token with following permission set to view private events: \"Events\" user permis{"code":"internal","msg":"git-diff-tree: context deadline exceeded","meta":{"cause":"*fmt.wrapError"}}