Merge pull request #1658 from github/openapi-update-ff4df3e02412576939969d929b7877d05e540a92794642cbba563e421b588081

Update OpenAPI 3.0 Descriptions

Author: dinonuggies1

descriptions/api.github.com/api.github.com.json

@@ -27693,6 +27693,10 @@
                   "tool_name": {
                     "description": "The name of the tool used to generate the code scanning analysis. If this parameter is not used, the tool name defaults to \"API\". If the uploaded SARIF contains a tool GUID, this will be available for filtering using the `tool_guid` parameter of operations such as `GET /repos/{owner}/{repo}/code-scanning/alerts`.",
                     "type": "string"
+                  },
+                  "validate": {
+                    "description": "Whether the SARIF file will be validated according to the code scanning specifications.\nThis parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.",
+                    "type": "boolean"
                   }
                 },
                 "required": [

descriptions/api.github.com/api.github.com.yaml

@@ -20059,6 +20059,11 @@ paths:
                     be available for filtering using the `tool_guid` parameter of
                     operations such as `GET /repos/{owner}/{repo}/code-scanning/alerts`.
                   type: string
+                validate:
+                  description: |-
+                    Whether the SARIF file will be validated according to the code scanning specifications.
+                    This parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.
+                  type: boolean
               required:
               - commit_sha
               - ref

descriptions/api.github.com/dereferenced/api.github.com.deref.json

@@ -181745,6 +181745,10 @@
                   "tool_name": {
                     "description": "The name of the tool used to generate the code scanning analysis. If this parameter is not used, the tool name defaults to \"API\". If the uploaded SARIF contains a tool GUID, this will be available for filtering using the `tool_guid` parameter of operations such as `GET /repos/{owner}/{repo}/code-scanning/alerts`.",
                     "type": "string"
+                  },
+                  "validate": {
+                    "description": "Whether the SARIF file will be validated according to the code scanning specifications.\nThis parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.",
+                    "type": "boolean"
                   }
                 },
                 "required": [

descriptions/api.github.com/dereferenced/api.github.com.deref.yaml

@@ -41938,6 +41938,11 @@ paths:
                     be available for filtering using the `tool_guid` parameter of
                     operations such as `GET /repos/{owner}/{repo}/code-scanning/alerts`.
                   type: string
+                validate:
+                  description: |-
+                    Whether the SARIF file will be validated according to the code scanning specifications.
+                    This parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.
+                  type: boolean
               required:
               - commit_sha
               - ref

descriptions/ghec/dereferenced/ghec.deref.json

@@ -185084,6 +185084,10 @@
                   "tool_name": {
                     "description": "The name of the tool used to generate the code scanning analysis. If this parameter is not used, the tool name defaults to \"API\". If the uploaded SARIF contains a tool GUID, this will be available for filtering using the `tool_guid` parameter of operations such as `GET /repos/{owner}/{repo}/code-scanning/alerts`.",
                     "type": "string"
+                  },
+                  "validate": {
+                    "description": "Whether the SARIF file will be validated according to the code scanning specifications.\nThis parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.",
+                    "type": "boolean"
                   }
                 },
                 "required": [

descriptions/ghec/dereferenced/ghec.deref.yaml

@@ -43433,6 +43433,11 @@ paths:
                     be available for filtering using the `tool_guid` parameter of
                     operations such as `GET /repos/{owner}/{repo}/code-scanning/alerts`.
                   type: string
+                validate:
+                  description: |-
+                    Whether the SARIF file will be validated according to the code scanning specifications.
+                    This parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.
+                  type: boolean
               required:
               - commit_sha
               - ref

descriptions/ghec/ghec.json

@@ -28927,6 +28927,10 @@
                   "tool_name": {
                     "description": "The name of the tool used to generate the code scanning analysis. If this parameter is not used, the tool name defaults to \"API\". If the uploaded SARIF contains a tool GUID, this will be available for filtering using the `tool_guid` parameter of operations such as `GET /repos/{owner}/{repo}/code-scanning/alerts`.",
                     "type": "string"
+                  },
+                  "validate": {
+                    "description": "Whether the SARIF file will be validated according to the code scanning specifications.\nThis parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.",
+                    "type": "boolean"
                   }
                 },
                 "required": [

descriptions/ghec/ghec.yaml

@@ -20920,6 +20920,11 @@ paths:
                     be available for filtering using the `tool_guid` parameter of
                     operations such as `GET /repos/{owner}/{repo}/code-scanning/alerts`.
                   type: string
+                validate:
+                  description: |-
+                    Whether the SARIF file will be validated according to the code scanning specifications.
+                    This parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.
+                  type: boolean
               required:
               - commit_sha
               - ref