Merge pull request #3039 from github/openapi-update-beb65226f322c7fb7bb24341ba90b9d7b75000374d796e1775d19105c9a1726e

Update OpenAPI 3.1 Descriptions

Author: shiftkey

descriptions-next/api.github.com/api.github.com.2022-11-28.json

@@ -104256,6 +104256,13 @@
             "type": "string",
             "format": "uri",
             "description": "The URL at which to download the CodeQL database. The `Accept` header must be set to the value of the `content_type` property."
+          },
+          "commit_oid": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The commit SHA of the CodeQL databases repository at time of database creation."
           }
         },
         "required": [
@@ -298178,7 +298185,8 @@
             "size": 1024,
             "created_at": "2022-09-12T12:14:32Z",
             "updated_at": "2022-09-12T12:14:32Z",
-            "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java"
+            "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java",
+            "commit_oid": 12345678901234567890
           },
           {
             "id": 2,
@@ -298208,7 +298216,8 @@
             "size": 1024,
             "created_at": "2022-09-12T12:14:32Z",
             "updated_at": "2022-09-12T12:14:32Z",
-            "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby"
+            "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby",
+            "commit_oid": 23456789012345678901
           }
         ]
       },
@@ -298241,7 +298250,8 @@
           "size": 1024,
           "created_at": "2022-09-12T12:14:32Z",
           "updated_at": "2022-09-12T12:14:32Z",
-          "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java"
+          "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java",
+          "commit_oid": 12345678901234567890
         }
       },
       "code-scanning-default-setup": {

descriptions-next/api.github.com/api.github.com.2022-11-28.yaml

@@ -74666,6 +74666,12 @@ components:
           format: uri
           description: The URL at which to download the CodeQL database. The `Accept`
             header must be set to the value of the `content_type` property.
+        commit_oid:
+          type:
+          - string
+          - 'null'
+          description: The commit SHA of the CodeQL databases repository at time of
+            database creation.
       required:
       - id
       - name
@@ -220275,6 +220281,7 @@ components:
         created_at: '2022-09-12T12:14:32Z'
         updated_at: '2022-09-12T12:14:32Z'
         url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java
+        commit_oid: 12345678901234567890
       - id: 2
         name: database.zip
         language: ruby
@@ -220302,6 +220309,7 @@ components:
         created_at: '2022-09-12T12:14:32Z'
         updated_at: '2022-09-12T12:14:32Z'
         url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby
+        commit_oid: 23456789012345678901
     code-scanning-codeql-database:
       value:
         id: 1
@@ -220331,6 +220339,7 @@ components:
         created_at: '2022-09-12T12:14:32Z'
         updated_at: '2022-09-12T12:14:32Z'
         url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java
+        commit_oid: 12345678901234567890
     code-scanning-default-setup:
       value:
         state: configured

descriptions-next/api.github.com/api.github.com.json

@@ -104256,6 +104256,13 @@
             "type": "string",
             "format": "uri",
             "description": "The URL at which to download the CodeQL database. The `Accept` header must be set to the value of the `content_type` property."
+          },
+          "commit_oid": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The commit SHA of the CodeQL databases repository at time of database creation."
           }
         },
         "required": [
@@ -298178,7 +298185,8 @@
             "size": 1024,
             "created_at": "2022-09-12T12:14:32Z",
             "updated_at": "2022-09-12T12:14:32Z",
-            "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java"
+            "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java",
+            "commit_oid": 12345678901234567890
           },
           {
             "id": 2,
@@ -298208,7 +298216,8 @@
             "size": 1024,
             "created_at": "2022-09-12T12:14:32Z",
             "updated_at": "2022-09-12T12:14:32Z",
-            "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby"
+            "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby",
+            "commit_oid": 23456789012345678901
           }
         ]
       },
@@ -298241,7 +298250,8 @@
           "size": 1024,
           "created_at": "2022-09-12T12:14:32Z",
           "updated_at": "2022-09-12T12:14:32Z",
-          "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java"
+          "url": "https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java",
+          "commit_oid": 12345678901234567890
         }
       },
       "code-scanning-default-setup": {