Update OpenAPI Description (#60759)

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": "3ba1e7273bb94c613cf608640e4a7a860310669b"
+  "sha": "e6a345665a64530821d4ebcd07e7805a0cdeff09"
 }

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

@@ -9439,8 +9439,13 @@
         {
           "type": "array of objects",
           "name": "options",
-          "description": "<p>Options for single select fields. Only applicable when updating single_select fields.</p>",
+          "description": "<p>Options for single select fields. Only applicable when updating single_select fields. When provided, this array <strong>replaces</strong> the entire existing set of options rather than adding to or updating individual options. To retain or update an existing option, include it in the array with its <code>id</code>. Options sent without an <code>id</code> are treated as new options and may cause existing options to be deleted and recreated.</p>",
           "childParamsGroups": [
+            {
+              "type": "integer",
+              "name": "id",
+              "description": "<p>The id of an existing option to retain or update. Omit this when creating a new option.</p>"
+            },
             {
               "type": "string",
               "name": "name",

src/rest/data/fpt-2022-11-28/secret-scanning.json

@@ -6563,7 +6563,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Lists the latest default incremental and backfill scans by type for a repository. Scans from Copilot Secret Scanning are not included.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nThis endpoint requires <a href=\"https://docs.github.com/get-started/learning-about-github/about-github-advanced-security\">GitHub Advanced Security</a>.\"</p>\n</div>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> or <code>security_events</code> scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the <code>public_repo</code> scope instead.</p>",
+      "descriptionHTML": "<p>Lists the latest default incremental and backfill scans by type for a repository.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nThis endpoint requires <a href=\"https://docs.github.com/get-started/learning-about-github/about-github-advanced-security\">GitHub Advanced Security</a>.</p>\n</div>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> or <code>security_events</code> scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the <code>public_repo</code> scope instead.</p>",
       "codeExamples": [
         {
           "request": {
@@ -6631,6 +6631,14 @@
                   "pattern_slug": "my-custom-pattern",
                   "pattern_scope": "organization"
                 }
+              ],
+              "generic_secrets_backfill_scans": [
+                {
+                  "type": "git",
+                  "status": "completed",
+                  "started_at": "2024-10-07T02:47:00Z",
+                  "completed_at": "2024-10-07T02:55:00Z"
+                }
               ]
             },
             "schema": {
@@ -6784,6 +6792,39 @@
                       }
                     ]
                   }
+                },
+                "generic_secrets_backfill_scans": {
+                  "type": "array",
+                  "items": {
+                    "description": "Information on a single scan performed by secret scanning on the repository",
+                    "type": "object",
+                    "properties": {
+                      "type": {
+                        "type": "string",
+                        "description": "The type of scan"
+                      },
+                      "status": {
+                        "type": "string",
+                        "description": "The state of the scan. Either \"completed\", \"running\", or \"pending\""
+                      },
+                      "completed_at": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "date-time",
+                        "description": "The time that the scan was completed. Empty if the scan is running"
+                      },
+                      "started_at": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "date-time",
+                        "description": "The time that the scan was started. Empty if the scan is pending"
+                      }
+                    }
+                  }
                 }
               }
             }

src/rest/data/fpt-2026-03-10/gists.json

@@ -5697,7 +5697,6 @@
               "updated_at": "2011-06-20T11:34:15Z",
               "description": "Hello World Examples",
               "comments": 0,
-              "user": null,
               "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
               "owner": {
                 "login": "octocat",