Update OpenAPI 3.0 Descriptions

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

@@ -111207,6 +111207,7 @@ x-webhooks:
                       - push_ruleset_bypass
                       - secret_scanning
                       - secret_scanning_closure
+                      - code_scanning_alert_dismissal
                     exemption_request_data:
                       oneOf:
                       - title: Push ruleset bypass exemption request data
@@ -111300,6 +111301,25 @@ x-webhooks:
                                 alert_number:
                                   type: string
                                   description: The number of the alert that was detected
+                      - title: Code scanning alert dismissal request data
+                        description: Code scanning alerts that have dismissal requests.
+                        type: object
+                        properties:
+                          type:
+                            type: string
+                            description: The type of request
+                            enum:
+                            - code_scanning_alert_dismissal
+                          data:
+                            type: array
+                            description: The data related to the code scanning alerts
+                              that have dismissal requests.
+                            items:
+                              type: object
+                              properties:
+                                alert_number:
+                                  type: string
+                                  description: The number of the alert to be dismissed
                     resource_identifier:
                       type: string
                       description: The unique identifier for the request type of the
@@ -111322,7 +111342,7 @@ x-webhooks:
                       type: object
                       description: Metadata about the exemption request.
                       nullable: true
-                      oneOf:
+                      anyOf:
                       - title: Secret Scanning Push Protection Exemption Request Metadata
                         description: Metadata for a secret scanning push protection
                           exemption request.
@@ -111354,6 +111374,21 @@ x-webhooks:
                             - false_positive
                             - tests
                             - revoked
+                      - title: Code scanning alert dismissal request metadata
+                        description: Metadata for a code scanning alert dismissal
+                          request.
+                        type: object
+                        properties:
+                          alert_title:
+                            type: string
+                            description: The title of the code scanning alert
+                          reason:
+                            type: string
+                            description: The reason for the dismissal request
+                            enum:
+                            - false positive
+                            - won't fix
+                            - used in tests
                     expires_at:
                       type: string
                       format: date-time
@@ -127065,6 +127100,138 @@ x-webhooks:
         - repository
         - organization
         - app
+  dismissal-request-code-scanning-created:
+    post:
+      summary: |-
+        This event occurs when there is activity related to a user's request to dismiss a code scanning alert.
+
+        To subscribe to this event, a GitHub App must have at least read-level access for the "code scanning alerts" repository permission.
+
+        > [!NOTE]
+        > Delegated alert dismissal for code scanning is currently in public preview and subject to change.
+      description: A code scanning alert dismissal request was created.
+      operationId: dismissal-request-code-scanning/created
+      externalDocs:
+        url: https://docs.github.com/enterprise-cloud@latest//webhooks/webhook-events-and-payloads#dismissal_request_code_scanning
+      parameters:
+      - name: User-Agent
+        in: header
+        example: GitHub-Hookshot/123abc
+        schema:
+          type: string
+      - name: X-Github-Hook-Id
+        in: header
+        example: 12312312
+        schema:
+          type: string
+      - name: X-Github-Event
+        in: header
+        example: issues
+        schema:
+          type: string
+      - name: X-Github-Hook-Installation-Target-Id
+        in: header
+        example: 123123
+        schema:
+          type: string
+      - name: X-Github-Hook-Installation-Target-Type
+        in: header
+        example: repository
+        schema:
+          type: string
+      - name: X-GitHub-Delivery
+        in: header
+        example: 0b989ba4-242f-11e5-81e1-c7b6966d2516
+        schema:
+          type: string
+      - name: X-Hub-Signature-256
+        in: header
+        example: sha256=6dcb09b5b57875f334f61aebed695e2e4193db5e
+        schema:
+          type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: *756
+      responses:
+        '200':
+          description: Return a 200 status to indicate that the data was received
+            successfully
+      x-github:
+        githubCloudOnly: true
+        category: webhooks
+        subcategory: dismissal_request_code_scanning
+        supported-webhook-types:
+        - repository
+        - organization
+        - app
+  dismissal-request-code-scanning-response-submitted:
+    post:
+      summary: |-
+        This event occurs when there is activity related to a user's request to dismiss a code scanning alert.
+
+        To subscribe to this event, a GitHub App must have at least read-level access for the "code scanning alerts" repository permission.
+
+        > [!NOTE]
+        > Delegated alert dismissal for code scanning is currently in public preview and subject to change.
+      description: A code scanning alert dismissal response was submitted.
+      operationId: dismissal-request-code-scanning/response-submitted
+      externalDocs:
+        url: https://docs.github.com/enterprise-cloud@latest//webhooks/webhook-events-and-payloads#dismissal_request_code_scanning
+      parameters:
+      - name: User-Agent
+        in: header
+        example: GitHub-Hookshot/123abc
+        schema:
+          type: string
+      - name: X-Github-Hook-Id
+        in: header
+        example: 12312312
+        schema:
+          type: string
+      - name: X-Github-Event
+        in: header
+        example: issues
+        schema:
+          type: string
+      - name: X-Github-Hook-Installation-Target-Id
+        in: header
+        example: 123123
+        schema:
+          type: string
+      - name: X-Github-Hook-Installation-Target-Type
+        in: header
+        example: repository
+        schema:
+          type: string
+      - name: X-GitHub-Delivery
+        in: header
+        example: 0b989ba4-242f-11e5-81e1-c7b6966d2516
+        schema:
+          type: string
+      - name: X-Hub-Signature-256
+        in: header
+        example: sha256=6dcb09b5b57875f334f61aebed695e2e4193db5e
+        schema:
+          type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: *758
+      responses:
+        '200':
+          description: Return a 200 status to indicate that the data was received
+            successfully
+      x-github:
+        githubCloudOnly: true
+        category: webhooks
+        subcategory: dismissal_request_code_scanning
+        supported-webhook-types:
+        - repository
+        - organization
+        - app
   dismissal-request-secret-scanning-cancelled:
     post:
       summary: |-