Update OpenAPI 3.0 Descriptions

descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml

@@ -10387,6 +10387,9 @@ paths:
     get:
       summary: Get code security and analysis features for an enterprise
       description: |-
+        > [!WARNING]
+        > **Deprecation notice:** The ability to fetch code security and analysis settings for an enterprise is deprecated. Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations) instead. For more information, see the [changelog](https://github.blog/changelog/2024-09-27-upcoming-replacement-of-enterprise-code-security-enablement-ui-and-apis).
+
         Gets code security and analysis settings for the specified enterprise.
 
         The authenticated user must be an administrator of the enterprise in order to use this endpoint.
@@ -10476,9 +10479,15 @@ paths:
         enabledForGitHubApps: false
         category: enterprise-admin
         subcategory: code-security-and-analysis
+        deprecationDate: '2024-09-27'
+        removalDate: '2025-09-27'
+      deprecated: true
     patch:
       summary: Update code security and analysis features for an enterprise
       description: |-
+        > [!WARNING]
+        > **Deprecation notice:** The ability to update code security and analysis settings for an enterprise is deprecated. Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations) instead. For more information, see the [changelog](https://github.blog/changelog/2024-09-27-upcoming-replacement-of-enterprise-code-security-enablement-ui-and-apis).
+
         Updates the settings for advanced security, Dependabot alerts, secret scanning, and push protection for new repositories in an enterprise.
 
         The authenticated user must be an administrator of the enterprise to use this endpoint.
@@ -10556,6 +10565,9 @@ paths:
         enabledForGitHubApps: false
         category: enterprise-admin
         subcategory: code-security-and-analysis
+        deprecationDate: '2024-09-27'
+        removalDate: '2025-09-27'
+      deprecated: true
   "/enterprises/{enterprise}/consumed-licenses":
     get:
       summary: List enterprise consumed licenses
@@ -13265,6 +13277,9 @@ paths:
     post:
       summary: Enable or disable a security feature
       description: |-
+        > [!WARNING]
+        > **Deprecation notice:** The ability to enable or disable a security feature for an enterprise is deprecated. Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations) instead. For more information, see the [changelog](https://github.blog/changelog/2024-09-27-upcoming-replacement-of-enterprise-code-security-enablement-ui-and-apis).
+
         Enables or disables the specified security feature for all repositories in an enterprise.
 
         The authenticated user must be an administrator of the enterprise to use this endpoint.
@@ -13316,6 +13331,9 @@ paths:
         enabledForGitHubApps: false
         category: enterprise-admin
         subcategory: code-security-and-analysis
+        deprecationDate: '2024-09-27'
+        removalDate: '2025-09-27'
+      deprecated: true
   "/events":
     get:
       summary: List public events
@@ -35105,8 +35123,9 @@ paths:
                             description: The ID of the actor that can bypass a ruleset.
                               If `actor_type` is `OrganizationAdmin`, this should
                               be `1`. If `actor_type` is `DeployKey`, this should
-                              be null. `OrganizationAdmin` is not applicable for personal
-                              repositories.
+                              be null. If `actor_type` is `EnterpriseOwner`, `actor_id`
+                              is ignored. `OrganizationAdmin` and `EnterpriseOwner`
+                              are not applicable for personal repositories.
                           actor_type:
                             type: string
                             enum:
@@ -35115,7 +35134,8 @@ paths:
                             - RepositoryRole
                             - Team
                             - DeployKey
-                            description: The type of actor that can bypass a ruleset.
+                            - EnterpriseOwner
+                            description: The type of actor that can bypass a ruleset
                           bypass_mode:
                             type: string
                             description: When the specified actor can bypass the ruleset.