Update OpenAPI Description (#62916)

Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>

Author: docs-bot

src/github-apps/lib/config.json

@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "d77b7dde24f7b3a52b3532b1337d4be8a60fb34d"
+  "sha": "fee3373e1517aa7a3510c5db165154f47baf8d97"
 }

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

@@ -7049,24 +7049,6 @@
             ]
           }
         },
-        {
-          "name": "page",
-          "description": "<p>The page number of the results to fetch. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
-          "in": "query",
-          "schema": {
-            "type": "integer",
-            "default": 1
-          }
-        },
-        {
-          "name": "per_page",
-          "description": "<p>The number of results per page (max 100). For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
-          "in": "query",
-          "schema": {
-            "type": "integer",
-            "default": 30
-          }
-        },
         {
           "name": "before",
           "description": "<p>A cursor, as given in the <a href=\"https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers\">Link header</a>. If specified, the query only searches for results before this cursor. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
@@ -7965,24 +7947,6 @@
             ]
           }
         },
-        {
-          "name": "page",
-          "description": "<p>The page number of the results to fetch. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
-          "in": "query",
-          "schema": {
-            "type": "integer",
-            "default": 1
-          }
-        },
-        {
-          "name": "per_page",
-          "description": "<p>The number of results per page (max 100). For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
-          "in": "query",
-          "schema": {
-            "type": "integer",
-            "default": 30
-          }
-        },
         {
           "name": "before",
           "description": "<p>A cursor, as given in the <a href=\"https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers\">Link header</a>. If specified, the query only searches for results before this cursor. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",

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

@@ -7049,24 +7049,6 @@
             ]
           }
         },
-        {
-          "name": "page",
-          "description": "<p>The page number of the results to fetch. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
-          "in": "query",
-          "schema": {
-            "type": "integer",
-            "default": 1
-          }
-        },
-        {
-          "name": "per_page",
-          "description": "<p>The number of results per page (max 100). For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
-          "in": "query",
-          "schema": {
-            "type": "integer",
-            "default": 30
-          }
-        },
         {
           "name": "before",
           "description": "<p>A cursor, as given in the <a href=\"https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers\">Link header</a>. If specified, the query only searches for results before this cursor. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
@@ -7965,24 +7947,6 @@
             ]
           }
         },
-        {
-          "name": "page",
-          "description": "<p>The page number of the results to fetch. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
-          "in": "query",
-          "schema": {
-            "type": "integer",
-            "default": 1
-          }
-        },
-        {
-          "name": "per_page",
-          "description": "<p>The number of results per page (max 100). For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",
-          "in": "query",
-          "schema": {
-            "type": "integer",
-            "default": 30
-          }
-        },
         {
           "name": "before",
           "description": "<p>A cursor, as given in the <a href=\"https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers\">Link header</a>. If specified, the query only searches for results before this cursor. For more information, see \"<a href=\"https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api\">Using pagination in the REST API</a>.\"</p>",

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

@@ -247,7 +247,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets budgets for an enterprise. Enterprise owners and billing managers can view all budgets, and organization administrators can view budgets scoped to organizations and repositories they administer. A custom role holder with fine-grained read access to enterprise billing can also view budgets. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can list all budgets in the enterprise.\nEach page returns up to 100 budgets.</p>",
+      "descriptionHTML": "<p>Gets budgets for an enterprise. Enterprise owners and billing managers can view all budgets, and organization administrators can view budgets scoped to organizations and repositories they administer. A custom role holder with fine-grained read access to enterprise billing can view non-repository budgets; repository-scoped budgets require the organization administrator permissions described above. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can list all budgets in the enterprise.\nEach page returns up to 100 budgets.</p>",
       "codeExamples": [
         {
           "request": {
@@ -970,7 +970,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets a budget by ID. Enterprise owners and billing managers can view any budget in the enterprise, and organization administrators can view budgets scoped to organizations and repositories they administer. A custom role holder with fine-grained read access to enterprise billing can also view the budget. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get any budget in the enterprise.</p>",
+      "descriptionHTML": "<p>Gets a budget by ID. Enterprise owners and billing managers can view any budget in the enterprise, and organization administrators can view budgets scoped to organizations and repositories they administer. A custom role holder with fine-grained read access to enterprise billing can view the budget unless it is scoped to a repository; repository-scoped budgets require the organization administrator permissions described above. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get any budget in the enterprise.</p>",
       "codeExamples": [
         {
           "request": {
@@ -2770,7 +2770,7 @@
           "description": "<p>The enterprise teams to add to the cost center.</p>"
         }
       ],
-      "descriptionHTML": "<p>Adds resources to a cost center.</p>\n<p>The usage for the resources will be charged to the cost center's budget. Enterprise owners and billing managers can add any resource, and organization owners can add non-team resources to cost centers associated with resources they administer. A custom role holder with fine-grained write access to enterprise billing can also add resources. An installation access token for a GitHub App installed on the enterprise with write access to enterprise billing can add resources to any cost center in the enterprise.</p>",
+      "descriptionHTML": "<p>Adds resources to a cost center.</p>\n<p>The usage for the resources will be charged to the cost center's budget. Enterprise owners and billing managers can add any resource, and organization owners can add non-team resources to cost centers associated with resources they administer. A custom role holder with fine-grained write access to enterprise billing can add users in the enterprise who are visible to them and organizations or repositories they administer, but cannot add enterprise teams. An installation access token for a GitHub App installed on the enterprise with write access to enterprise billing can add resources to any cost center in the enterprise.</p>",
       "codeExamples": [
         {
           "request": {
@@ -2937,7 +2937,7 @@
           "description": "<p>The enterprise teams to remove from the cost center.</p>"
         }
       ],
-      "descriptionHTML": "<p>Remove resources from a cost center.</p>\n<p>The usage for the resources will no longer be charged to the cost center's budget. Enterprise owners and billing managers can remove any resource, and organization owners can remove non-team resources from cost centers associated with resources they administer. A custom role holder with fine-grained write access to enterprise billing can also remove resources. An installation access token for a GitHub App installed on the enterprise with write access to enterprise billing can remove resources from any cost center in the enterprise.</p>",
+      "descriptionHTML": "<p>Remove resources from a cost center.</p>\n<p>The usage for the resources will no longer be charged to the cost center's budget. Enterprise owners and billing managers can remove any resource, and organization owners can remove non-team resources from cost centers associated with resources they administer. A custom role holder with fine-grained write access to enterprise billing can remove users and any organizations or repositories they administer; only enterprise owners and billing managers can remove enterprise teams. An installation access token for a GitHub App installed on the enterprise with write access to enterprise billing can remove users from any cost center in the enterprise.</p>",
       "codeExamples": [
         {
           "request": {
@@ -3099,7 +3099,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets a report of AI credit usage for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, or a custom role holder with fine-grained read access to enterprise billing. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage report.</p>\n<p><strong>Note:</strong> Only data from the past 24 months is accessible via this endpoint.</p>",
+      "descriptionHTML": "<p>Gets a report of AI credit usage for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, an organization owner in the enterprise, or a custom role holder with fine-grained read access to enterprise billing. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage report.</p>\n<p><strong>Note:</strong> Only data from the past 24 months is accessible via this endpoint.</p>",
       "codeExamples": [
         {
           "request": {
@@ -3398,7 +3398,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets a report of premium request usage for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, or a custom role holder with fine-grained read access to enterprise billing. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage report.</p>\n<p><strong>Note:</strong> Only data from the past 24 months is accessible via this endpoint.</p>",
+      "descriptionHTML": "<p>Gets a report of premium request usage for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, an organization owner in the enterprise, or a custom role holder with fine-grained read access to enterprise billing. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage report.</p>\n<p><strong>Note:</strong> Only data from the past 24 months is accessible via this endpoint.</p>",
       "codeExamples": [
         {
           "request": {
@@ -3661,7 +3661,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets a report of usage by cost center for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, or a custom role holder with fine-grained read access to enterprise billing. By default this endpoint will return usage that does not have a cost center. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage report.</p>\n<p><strong>Note:</strong> This endpoint is only available to enterprises with access to the enhanced billing platform. For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest/billing/using-the-enhanced-billing-platform-for-enterprises/about-the-enhanced-billing-platform-for-enterprises#how-do-i-know-if-i-can-access-the-enhanced-billing-platform\">About the enhanced billing platform for enterprises</a>.\"</p>",
+      "descriptionHTML": "<p>Gets a report of usage by cost center for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, an organization owner in the enterprise, or a custom role holder with fine-grained read access to enterprise billing. By default this endpoint will return usage that does not have a cost center. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage report.</p>\n<p><strong>Note:</strong> This endpoint is only available to enterprises with access to the enhanced billing platform. For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest/billing/using-the-enhanced-billing-platform-for-enterprises/about-the-enhanced-billing-platform-for-enterprises#how-do-i-know-if-i-can-access-the-enhanced-billing-platform\">About the enhanced billing platform for enterprises</a>.\"</p>",
       "codeExamples": [
         {
           "request": {
@@ -3889,7 +3889,7 @@
         }
       ],
       "bodyParameters": [],
-      "descriptionHTML": "<p>Gets a summary report of usage for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, or a custom role holder with fine-grained read access to enterprise billing. By default, this endpoint will return usage across all cost centers in the enterprise. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage summary report.</p>\n<p><strong>Note:</strong> Only data from the past 24 months is accessible via this endpoint.</p>",
+      "descriptionHTML": "<p>Gets a summary report of usage for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, an organization owner in the enterprise, or a custom role holder with fine-grained read access to enterprise billing. By default, this endpoint will return usage across all cost centers in the enterprise. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage summary report.</p>\n<p><strong>Note:</strong> Only data from the past 24 months is accessible via this endpoint.</p>",
       "codeExamples": [
         {
           "request": {