Update OpenAPI Description (#60693)

Co-authored-by: Ben Ahmady <32935794+subatoi@users.noreply.github.com>

Author: docs-bot

src/github-apps/lib/config.json

@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "3d5beeaa2dab037828a246d389b492f18a0b35ad"
+  "sha": "36e6d2087a74bda6b56e450420eee3427798bc75"
 }

src/rest/data/fpt-2022-11-28/agent-tasks.json

@@ -2616,7 +2616,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets a specified gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.base64+json</code></strong>: Returns the base64-encoded contents. This can be useful if your gist contains any invalid UTF-8 sequences.</li>\n</ul>",
+      "descriptionHTML": "<p>Gets a specified gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n</ul>",
       "codeExamples": [
         {
           "request": {
@@ -3768,7 +3768,7 @@
           ]
         }
       ],
-      "descriptionHTML": "<p>Allows you to update a gist's description and to update, delete, or rename gist files. Files\nfrom the previous version of the gist that aren't explicitly changed during an edit\nare unchanged.</p>\n<p>At least one of <code>description</code> or <code>files</code> is required.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.base64+json</code></strong>: Returns the base64-encoded contents. This can be useful if your gist contains any invalid UTF-8 sequences.</li>\n</ul>",
+      "descriptionHTML": "<p>Allows you to update a gist's description and to update, delete, or rename gist files. Files\nfrom the previous version of the gist that aren't explicitly changed during an edit\nare unchanged.</p>\n<p>At least one of <code>description</code> or <code>files</code> is required.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n</ul>",
       "codeExamples": [
         {
           "request": {
@@ -9157,7 +9157,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets a specified gist revision.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.base64+json</code></strong>: Returns the base64-encoded contents. This can be useful if your gist contains any invalid UTF-8 sequences.</li>\n</ul>",
+      "descriptionHTML": "<p>Gets a specified gist revision.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n</ul>",
       "codeExamples": [
         {
           "request": {
@@ -10785,7 +10785,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Lists the comments on a gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.base64+json</code></strong>: Returns the base64-encoded contents. This can be useful if your gist contains any invalid UTF-8 sequences.</li>\n</ul>",
+      "descriptionHTML": "<p>Lists the comments on a gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n</ul>",
       "codeExamples": [
         {
           "request": {
@@ -11062,7 +11062,7 @@
           "isRequired": true
         }
       ],
-      "descriptionHTML": "<p>Creates a comment on a gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.base64+json</code></strong>: Returns the base64-encoded contents. This can be useful if your gist contains any invalid UTF-8 sequences.</li>\n</ul>",
+      "descriptionHTML": "<p>Creates a comment on a gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n</ul>",
       "codeExamples": [
         {
           "request": {
@@ -11344,7 +11344,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets a comment on a gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.base64+json</code></strong>: Returns the base64-encoded contents. This can be useful if your gist contains any invalid UTF-8 sequences.</li>\n</ul>",
+      "descriptionHTML": "<p>Gets a comment on a gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n</ul>",
       "codeExamples": [
         {
           "request": {
@@ -11627,7 +11627,7 @@
           "isRequired": true
         }
       ],
-      "descriptionHTML": "<p>Updates a comment on a gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.base64+json</code></strong>: Returns the base64-encoded contents. This can be useful if your gist contains any invalid UTF-8 sequences.</li>\n</ul>",
+      "descriptionHTML": "<p>Updates a comment on a gist.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown. This is the default if you do not pass any specific media type.</li>\n</ul>",
       "codeExamples": [
         {
           "request": {

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

@@ -51,7 +51,16 @@
         {
           "name": "exclude_providers",
           "in": "query",
-          "description": "<p>A comma-separated list of provider names to exclude from the results.</p>",
+          "description": "<p>A comma-separated list of provider slugs to exclude from the results.\nProvider slugs use lowercase with underscores (e.g., <code>github_secret_scanning</code>, <code>clojars</code>).\nYou can find the provider slug in the <code>provider_slug</code> field of each alert.\nCannot be combined with the <code>providers</code> parameter.</p>",
+          "required": false,
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "providers",
+          "in": "query",
+          "description": "<p>A comma-separated list of provider slugs to filter by.\nProvider slugs use lowercase with underscores (e.g., <code>github_secret_scanning</code>, <code>clojars</code>).\nYou can find the provider slug in the <code>provider_slug</code> field of each alert.\nCannot be combined with the <code>exclude_providers</code> parameter.</p>",
           "required": false,
           "schema": {
             "type": "string"
@@ -587,6 +596,13 @@
                     ],
                     "description": "The provider of the secret that was detected."
                   },
+                  "provider_slug": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "description": "The slug identifier for the provider of the secret that was detected. Use this value for filtering by provider with the `providers` or `exclude_providers` parameters."
+                  },
                   "secret": {
                     "type": "string",
                     "description": "The secret that was detected."
@@ -1929,7 +1945,16 @@
         {
           "name": "exclude_providers",
           "in": "query",
-          "description": "<p>A comma-separated list of provider names to exclude from the results.</p>",
+          "description": "<p>A comma-separated list of provider slugs to exclude from the results.\nProvider slugs use lowercase with underscores (e.g., <code>github_secret_scanning</code>, <code>clojars</code>).\nYou can find the provider slug in the <code>provider_slug</code> field of each alert.\nCannot be combined with the <code>providers</code> parameter.</p>",
+          "required": false,
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "providers",
+          "in": "query",
+          "description": "<p>A comma-separated list of provider slugs to filter by.\nProvider slugs use lowercase with underscores (e.g., <code>github_secret_scanning</code>, <code>clojars</code>).\nYou can find the provider slug in the <code>provider_slug</code> field of each alert.\nCannot be combined with the <code>exclude_providers</code> parameter.</p>",
           "required": false,
           "schema": {
             "type": "string"
@@ -2406,6 +2431,13 @@
                     ],
                     "description": "The provider of the secret that was detected."
                   },
+                  "provider_slug": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "description": "The slug identifier for the provider of the secret that was detected. Use this value for filtering by provider with the `providers` or `exclude_providers` parameters."
+                  },
                   "secret": {
                     "type": "string",
                     "description": "The secret that was detected."
@@ -3620,6 +3652,13 @@
                   ],
                   "description": "The provider of the secret that was detected."
                 },
+                "provider_slug": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "The slug identifier for the provider of the secret that was detected. Use this value for filtering by provider with the `providers` or `exclude_providers` parameters."
+                },
                 "secret": {
                   "type": "string",
                   "description": "The secret that was detected."
@@ -4903,6 +4942,13 @@
                   ],
                   "description": "The provider of the secret that was detected."
                 },
+                "provider_slug": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "The slug identifier for the provider of the secret that was detected. Use this value for filtering by provider with the `providers` or `exclude_providers` parameters."
+                },
                 "secret": {
                   "type": "string",
                   "description": "The secret that was detected."