Update OpenAPI Description (#54799)

Co-authored-by: Jules <19994093+jules-p@users.noreply.github.com>

Author: docs-bot

src/github-apps/lib/config.json

@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "afa8a986f4d2ae2625a2c6a5c36d27f2fa900d1a"
+  "sha": "ef11ae693506cf915544201a6da5abd61a286259"
 }

src/rest/data/fpt-2022-11-28/schema.json

@@ -638,8 +638,7 @@
             {
               "\"Actions\" repository permissions": "read"
             }
-          ],
-          "allowsPublicRead": true
+          ]
         },
         "codeExamples": [
           {
@@ -107463,6 +107462,7 @@
                     "id": {
                       "description": "Unique identifier of the webhook delivery.",
                       "type": "integer",
+                      "format": "int64",
                       "examples": [
                         42
                       ]
@@ -107533,6 +107533,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -107543,6 +107544,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -213632,7 +213634,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Creates or updates a repository development environment secret with an encrypted value. Encrypt your secret using\n<a href=\"https://libsodium.gitbook.io/doc/bindings_for_other_languages\">LibSodium</a>. For more information, see \"<a href=\"https://docs.github.com/rest/guides/encrypting-secrets-for-the-rest-api\">Encrypting secrets for the REST API</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
+        "descriptionHTML": "<p>Creates or updates a repository development environment secret with an encrypted value. Encrypt your secret using\n<a href=\"https://libsodium.gitbook.io/doc/bindings_for_other_languages\">LibSodium</a>. For more information, see \"<a href=\"https://docs.github.com/rest/guides/encrypting-secrets-for-the-rest-api\">Encrypting secrets for the REST API</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint. The associated user must be a repository admin.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "201",
@@ -213710,7 +213712,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Deletes a development environment secret in a repository using the secret name.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
+        "descriptionHTML": "<p>Deletes a development environment secret in a repository using the secret name.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint. The associated user must be a repository admin.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "204",
@@ -257435,7 +257437,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Enable a custom deployment protection rule for an environment.</p>\n<p>The authenticated user must have admin or owner permissions to the repository to use this endpoint.</p>\n<p>For more information about the app that is providing this custom deployment rule, see the <a href=\"https://docs.github.com/rest/apps/apps#get-an-app\">documentation for the <code>GET /apps/{app_slug}</code> endpoint</a>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
+        "descriptionHTML": "<p>Enable a custom deployment protection rule for an environment.</p>\n<p>The authenticated user must have admin or owner permissions to the repository to use this endpoint.</p>\n<p>For more information about the app that is providing this custom deployment rule, see the <a href=\"https://docs.github.com/rest/apps/apps#get-an-app\">documentation for the <code>GET /apps/{app_slug}</code> endpoint</a>, as well as the <a href=\"https://docs.github.com/actions/managing-workflow-runs-and-deployments/managing-deployments/creating-custom-deployment-protection-rules\">guide to creating custom deployment protection rules</a>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "201",
@@ -399455,6 +399457,22 @@
               "type": "string",
               "format": "date-time"
             }
+          },
+          {
+            "name": "token_id",
+            "description": "<p>The ID of the token</p>",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "array",
+              "maxItems": 50,
+              "items": {
+                "type": "string"
+              },
+              "examples": [
+                "token_id[]=1,token_id[]=2"
+              ]
+            }
           }
         ],
         "bodyParameters": [],
@@ -401208,6 +401226,22 @@
               "type": "string",
               "format": "date-time"
             }
+          },
+          {
+            "name": "token_id",
+            "description": "<p>The ID of the token</p>",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "array",
+              "maxItems": 50,
+              "items": {
+                "type": "string"
+              },
+              "examples": [
+                "token_id[]=1,token_id[]=2"
+              ]
+            }
           }
         ],
         "bodyParameters": [],
@@ -413255,6 +413289,7 @@
                     "id": {
                       "description": "Unique identifier of the webhook delivery.",
                       "type": "integer",
+                      "format": "int64",
                       "examples": [
                         42
                       ]
@@ -413325,6 +413360,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -413335,6 +413371,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -547290,6 +547327,7 @@
                     "id": {
                       "description": "Unique identifier of the webhook delivery.",
                       "type": "integer",
+                      "format": "int64",
                       "examples": [
                         42
                       ]
@@ -547360,6 +547398,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -547370,6 +547409,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]

src/rest/data/ghec-2022-11-28/schema.json

@@ -638,8 +638,7 @@
             {
               "\"Actions\" repository permissions": "read"
             }
-          ],
-          "allowsPublicRead": true
+          ]
         },
         "codeExamples": [
           {
@@ -116671,6 +116670,7 @@
                     "id": {
                       "description": "Unique identifier of the webhook delivery.",
                       "type": "integer",
+                      "format": "int64",
                       "examples": [
                         42
                       ]
@@ -116741,6 +116741,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -116751,6 +116752,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -224907,7 +224909,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Creates or updates a repository development environment secret with an encrypted value. Encrypt your secret using\n<a href=\"https://libsodium.gitbook.io/doc/bindings_for_other_languages\">LibSodium</a>. For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//rest/guides/encrypting-secrets-for-the-rest-api\">Encrypting secrets for the REST API</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
+        "descriptionHTML": "<p>Creates or updates a repository development environment secret with an encrypted value. Encrypt your secret using\n<a href=\"https://libsodium.gitbook.io/doc/bindings_for_other_languages\">LibSodium</a>. For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//rest/guides/encrypting-secrets-for-the-rest-api\">Encrypting secrets for the REST API</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint. The associated user must be a repository admin.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "201",
@@ -224985,7 +224987,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Deletes a development environment secret in a repository using the secret name.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
+        "descriptionHTML": "<p>Deletes a development environment secret in a repository using the secret name.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint. The associated user must be a repository admin.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "204",
@@ -271316,7 +271318,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Enable a custom deployment protection rule for an environment.</p>\n<p>The authenticated user must have admin or owner permissions to the repository to use this endpoint.</p>\n<p>For more information about the app that is providing this custom deployment rule, see the <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-an-app\">documentation for the <code>GET /apps/{app_slug}</code> endpoint</a>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
+        "descriptionHTML": "<p>Enable a custom deployment protection rule for an environment.</p>\n<p>The authenticated user must have admin or owner permissions to the repository to use this endpoint.</p>\n<p>For more information about the app that is providing this custom deployment rule, see the <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-an-app\">documentation for the <code>GET /apps/{app_slug}</code> endpoint</a>, as well as the <a href=\"https://docs.github.com/enterprise-cloud@latest//actions/managing-workflow-runs-and-deployments/managing-deployments/creating-custom-deployment-protection-rules\">guide to creating custom deployment protection rules</a>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "201",
@@ -437282,6 +437284,22 @@
               "type": "string",
               "format": "date-time"
             }
+          },
+          {
+            "name": "token_id",
+            "description": "<p>The ID of the token</p>",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "array",
+              "maxItems": 50,
+              "items": {
+                "type": "string"
+              },
+              "examples": [
+                "token_id[]=1,token_id[]=2"
+              ]
+            }
           }
         ],
         "bodyParameters": [],
@@ -439047,6 +439065,22 @@
               "type": "string",
               "format": "date-time"
             }
+          },
+          {
+            "name": "token_id",
+            "description": "<p>The ID of the token</p>",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "array",
+              "maxItems": 50,
+              "items": {
+                "type": "string"
+              },
+              "examples": [
+                "token_id[]=1,token_id[]=2"
+              ]
+            }
           }
         ],
         "bodyParameters": [],
@@ -451112,6 +451146,7 @@
                     "id": {
                       "description": "Unique identifier of the webhook delivery.",
                       "type": "integer",
+                      "format": "int64",
                       "examples": [
                         42
                       ]
@@ -451182,6 +451217,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -451192,6 +451228,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -586326,6 +586363,7 @@
                     "id": {
                       "description": "Unique identifier of the webhook delivery.",
                       "type": "integer",
+                      "format": "int64",
                       "examples": [
                         42
                       ]
@@ -586396,6 +586434,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]
@@ -586406,6 +586445,7 @@
                         "integer",
                         "null"
                       ],
+                      "format": "int64",
                       "examples": [
                         123
                       ]