From c1353e965de5a3760ee0e67848fd874dd1453283 Mon Sep 17 00:00:00 2001 From: moizsohailn-rgb Date: Sat, 13 Jun 2026 21:26:32 +0530 Subject: [PATCH] Revert "Repo sync" --- .../respond-to-a-security-incident.md | 8 +-- .../about-enterprise-plugin-standards.md | 6 +- .../configure-enterprise-plugin-standards.md | 7 +- .../disable-automatic-commands.md | 36 ---------- .../manage-agents/index.md | 1 - .../configure-copilot-cli.md | 4 +- .../use-copilot-cli/allowing-tools.md | 2 - .../github-credential-types.md | 4 +- content/rest/credentials/revoke.md | 1 + .../copilot/create-managed-settings.md | 2 - data/reusables/copilot/disable-bypass.md | 1 - data/reusables/credentials/revoke-via-api.md | 2 +- data/variables/copilot.yml | 3 - src/github-apps/lib/config.json | 2 +- src/rest/data/fpt-2022-11-28/billing.json | 4 +- .../data/fpt-2022-11-28/code-security.json | 71 +++++-------------- src/rest/data/fpt-2026-03-10/billing.json | 4 +- .../data/fpt-2026-03-10/code-security.json | 71 +++++-------------- src/rest/data/ghec-2022-11-28/billing.json | 4 +- .../data/ghec-2022-11-28/code-security.json | 71 +++++-------------- src/rest/data/ghec-2022-11-28/copilot.json | 2 +- src/rest/data/ghec-2026-03-10/billing.json | 4 +- .../data/ghec-2026-03-10/code-security.json | 71 +++++-------------- src/rest/data/ghec-2026-03-10/copilot.json | 2 +- .../ghes-3.17-2022-11-28/code-security.json | 65 ++++------------- .../ghes-3.18-2022-11-28/code-security.json | 65 ++++------------- .../ghes-3.18-2022-11-28/credentials.json | 71 +++++++++++++++++++ .../ghes-3.19-2022-11-28/code-security.json | 65 ++++------------- .../ghes-3.19-2022-11-28/credentials.json | 71 +++++++++++++++++++ .../ghes-3.20-2022-11-28/code-security.json | 65 ++++------------- .../ghes-3.20-2022-11-28/credentials.json | 71 +++++++++++++++++++ .../ghes-3.21-2022-11-28/code-security.json | 65 ++++------------- .../ghes-3.21-2022-11-28/credentials.json | 71 +++++++++++++++++++ .../ghes-3.21-2026-03-10/code-security.json | 65 ++++------------- .../ghes-3.21-2026-03-10/credentials.json | 71 +++++++++++++++++++ src/rest/lib/config.json | 2 +- src/webhooks/lib/config.json | 2 +- 37 files changed, 529 insertions(+), 603 deletions(-) delete mode 100644 content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/disable-automatic-commands.md delete mode 100644 data/reusables/copilot/create-managed-settings.md delete mode 100644 data/reusables/copilot/disable-bypass.md create mode 100644 src/rest/data/ghes-3.18-2022-11-28/credentials.json create mode 100644 src/rest/data/ghes-3.19-2022-11-28/credentials.json create mode 100644 src/rest/data/ghes-3.20-2022-11-28/credentials.json create mode 100644 src/rest/data/ghes-3.21-2022-11-28/credentials.json create mode 100644 src/rest/data/ghes-3.21-2026-03-10/credentials.json diff --git a/content/code-security/tutorials/secure-your-organization/respond-to-a-security-incident.md b/content/code-security/tutorials/secure-your-organization/respond-to-a-security-incident.md index 319c63ddac7e..03dd9640244f 100644 --- a/content/code-security/tutorials/secure-your-organization/respond-to-a-security-incident.md +++ b/content/code-security/tutorials/secure-your-organization/respond-to-a-security-incident.md @@ -101,18 +101,16 @@ There are several containment actions you can choose to perform to limit the att For exposed or exploited credentials, the most immediate action you can take is to revoke the affected credentials to prevent further misuse. -{% ifversion fpt or ghec %} - +{% ifversion fpt or ghec or ghes > 3.17 %} * **Revoke via the API** If the token is one of the following types, and the literal value of the token is known, you (or anybody) can revoke it by **submitting a request via the REST API**. See [AUTOTITLE](/rest/credentials/revoke?apiVersion=2022-11-28#revoke-a-list-of-credentials). * {% data variables.product.pat_v1_caps %} - * {% data variables.product.pat_v2_caps %} + * {% data variables.product.pat_v2_caps %}{% ifversion fpt or ghec or ghes > 3.20 %} * {% data variables.product.prodname_oauth_app %} access token * {% data variables.product.prodname_github_app %} user access token - * {% data variables.product.prodname_github_app %} refresh token - + * {% data variables.product.prodname_github_app %} refresh token{% endif %} {% endif %} * **Revocation and containment options** diff --git a/content/copilot/concepts/agents/about-enterprise-plugin-standards.md b/content/copilot/concepts/agents/about-enterprise-plugin-standards.md index 3ec8a7079ade..265dee54111b 100644 --- a/content/copilot/concepts/agents/about-enterprise-plugin-standards.md +++ b/content/copilot/concepts/agents/about-enterprise-plugin-standards.md @@ -17,7 +17,7 @@ redirect_from: > [!NOTE] This feature is in {% data variables.release-phases.public_preview %} and subject to change. -Enterprise-managed plugin standards allow administrators to **define and enforce policies for plugin availability**. By configuring a `{% data variables.copilot.managed_setting_file %}` file in the enterprise's `.github-private` repository, administrators can specify which plugin marketplaces are available to users and which plugins are installed automatically. +Enterprise-managed plugin standards allow administrators to **define and enforce policies for plugin availability**. By configuring a `settings.json` file in the enterprise's `.github-private` repository, administrators can specify which plugin marketplaces are available to users and which plugins are installed automatically. ## Where plugin standards apply @@ -30,14 +30,14 @@ Users must upgrade to a supported client version for these standards to be appli ## How plugin standards work -Enterprise plugin standards use a configuration file stored in your enterprise's `.github-private` repository. The configuration is defined in a `{% data variables.copilot.managed_setting_file %}` file at the following path: `.github/copilot/{% data variables.copilot.managed_setting_file %}`. This file was previously called `settings.json`, which is still supported. +Enterprise plugin standards use a configuration file stored in your enterprise's `.github-private` repository. The configuration is defined in a `settings.json` file at the following path: `.github/copilot/settings.json`. For plugin standards, the file can define: * **Known marketplaces**. Plugin marketplaces that are available to users for browsing and installing plugins. * **Default-enabled plugins**. Specific plugins that are automatically installed when users authenticate. -When a user authenticates to {% data variables.product.prodname_copilot_short %} in a supported client, the client queries an API endpoint that reads the `{% data variables.copilot.managed_setting_file %}` file. The policies defined in the file are then applied to the user's session. +When a user authenticates to {% data variables.product.prodname_copilot_short %} in a supported client, the client queries an API endpoint that reads the `settings.json` from the enterprise's `.github-private` repository. The policies defined in the file are then applied to the user's session. ## Why use enterprise-managed plugin standards diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards.md index b84f3d1e2910..419aeb5c0a20 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards.md @@ -2,7 +2,7 @@ title: Configuring enterprise plugin standards shortTitle: Configure plugin standards allowTitleToDifferFromFilename: true -intro: 'Configure enterprise plugin standards by defining a `{% data variables.copilot.managed_setting_file %}` file in your enterprise''s `.github-private` repository.' +intro: 'Configure enterprise plugin standards by defining a `settings.json` file in your enterprise''s `.github-private` repository.' permissions: Enterprise owners versions: feature: copilot @@ -16,8 +16,9 @@ category: You can apply settings to control users' available plugin marketplaces and default-installed plugins. These settings apply to users on your enterprise's {% data variables.product.prodname_copilot_short %} plan. For more information, see [AUTOTITLE](/copilot/concepts/agents/about-enterprise-plugin-standards). -{% data reusables.copilot.create-managed-settings %} -1. Add your plugin policy configuration to the file. The `{% data variables.copilot.managed_setting_file %}` file supports the following top-level properties: +1. In your enterprise's `.github-private` repository, navigate to the `.github/copilot/` directory. If you don't have a `.github-private` repository yet, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents). +1. Create or edit the `settings.json` file at `.github/copilot/settings.json`. +1. Add your plugin policy configuration to the file. The `settings.json` file supports the following top-level properties: ```json copy { diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/disable-automatic-commands.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/disable-automatic-commands.md deleted file mode 100644 index a165d7fa9542..000000000000 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/disable-automatic-commands.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Disabling automatic command approval in Copilot clients -shortTitle: Disable automatic commands -allowTitleToDifferFromFilename: true -intro: 'Disable yolo mode to stop agents from running commands without approval.' -permissions: Enterprise owners -versions: - feature: copilot -contentType: how-tos -category: - - Configure Copilot - - Manage Copilot for a team ---- - -> [!NOTE] This feature is in {% data variables.release-phases.public_preview %} and subject to change. - -You can prevent users from using modes that enable automatic approval of agent commands in {% data variables.copilot.copilot_cli_short %} and {% data variables.product.prodname_vscode_shortname %}. The `disableBypassPermissionsMode` setting is defined in your enterprise's `{% data variables.copilot.managed_setting_file %}` file and applies to users on your enterprise's {% data variables.product.prodname_copilot_short %} plan. - -This setting blocks users from using: - -* The `--yolo` or `--allow-all` flag -* The `/yolo` or `/allow-all` command -* All runtime paths that enable combined bypass mode - -This setting does **not** block individual flags such as `--allow-all-tools` or `--allow-all-paths`. - -{% data reusables.copilot.create-managed-settings %} -1. Add the following property. - - ```json copy - { - "permissions": { - "disableBypassPermissionsMode": "disable" - } - } - ``` diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/index.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/index.md index 8547dcfedab7..90ad18d2cd11 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/index.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/index.md @@ -7,7 +7,6 @@ versions: children: - /prepare-for-custom-agents - /configure-enterprise-plugin-standards - - /disable-automatic-commands - /monitor-agentic-activity - /enable-copilot-cloud-agent - /block-agentic-features diff --git a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md index 401593f7a40d..a078f952ea12 100644 --- a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md +++ b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md @@ -267,9 +267,7 @@ This flag combines: * `--allow-all-paths` (disable path verification). * `--allow-all-urls` (disables URL verification). -During an interactive session, you can also enable all permissions with the `/allow-all` or `/yolo` slash commands. - -{% data reusables.copilot.disable-bypass %} +> [!TIP] During an interactive session, you can also enable all permissions with the `/allow-all` or `/yolo` slash commands. ## Further reading diff --git a/content/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools.md b/content/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools.md index 8a60ae7ad9df..04f35a5b27d3 100644 --- a/content/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools.md +++ b/content/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools.md @@ -79,8 +79,6 @@ For details of the supported tool kinds, see [AUTOTITLE](/copilot/reference/copi The following command-line options give {% data variables.copilot.copilot_cli_short %} permission to use all available tools. -{% data reusables.copilot.disable-bypass %} - * `--allow-all-tools` — Full access to the available tools. * `--allow-all` or `--yolo` — Equivalent to using all of the `--allow-all-tools`, `--allow-all-paths`, and `--allow-all-urls` options when starting the CLI. diff --git a/content/organizations/managing-programmatic-access-to-your-organization/github-credential-types.md b/content/organizations/managing-programmatic-access-to-your-organization/github-credential-types.md index 005474c07b43..db6db67f8bcb 100644 --- a/content/organizations/managing-programmatic-access-to-your-organization/github-credential-types.md +++ b/content/organizations/managing-programmatic-access-to-your-organization/github-credential-types.md @@ -38,7 +38,7 @@ The following sections describe revocation options for each credential type base * If the token **belongs to you**, you can delete it via your personal account settings. See [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#deleting-a-personal-access-token). {% data reusables.credentials.revoke-via-api %} -* **Organization owners** and **enterprise owners** do not have direct visibility into or control over individual tokens. However, they can:{% ifversion fpt or ghec %} +* **Organization owners** and **enterprise owners** do not have direct visibility into or control over individual tokens. However, they can:{% ifversion fpt or ghec or ghes > 3.17 %} * Revoke them using the REST API, if the actual token value is known. See [AUTOTITLE](/rest/credentials/revoke?apiVersion=2022-11-28#revoke-a-list-of-credentials).{% endif %} * Restrict the access of {% data variables.product.pat_generic_plural %} to the organization or enterprise entirely. See [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/setting-a-personal-access-token-policy-for-your-organization) and [AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-personal-access-tokens-in-your-enterprise). * **Organization owners and enterprise owners** on {% data variables.product.prodname_ghe_cloud %} with SSO enforced can revoke the SSO authorization for a specific {% data variables.product.pat_v1 %}. See [Revoking SSO authorization](#revoking-sso-authorization) for details. @@ -49,7 +49,7 @@ The following sections describe revocation options for each credential type base * If the token **belongs to you**, you can delete it via your personal account settings. See [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#deleting-a-personal-access-token). {% data reusables.credentials.revoke-via-api %} * **Organization owners**: Can view and revoke individual tokens. Note, however, that when an organization owner revokes a {% data variables.product.pat_v2 %}, any SSH keys created by the token will continue to work and the token will still be able to read public resources within the organization. The revocation changes the resource owner from the organization to the user, and the user can reassign it back. See [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/reviewing-and-revoking-personal-access-tokens-in-your-organization). -* **Organization owners** and **enterprise owners** can:{% ifversion fpt or ghec %} +* **Organization owners** and **enterprise owners** can:{% ifversion fpt or ghec or ghes > 3.17 %} * Revoke the token using the REST API. See [AUTOTITLE](/rest/credentials/revoke?apiVersion=2022-11-28#revoke-a-list-of-credentials).{% endif %} * Restrict the access of {% data variables.product.pat_generic_plural %} to the organization or enterprise entirely. See [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/setting-a-personal-access-token-policy-for-your-organization) and [AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-personal-access-tokens-in-your-enterprise). * **Revoked automatically** if pushed to a public repository or gist, or if unused for one year. See [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/token-expiration-and-revocation). diff --git a/content/rest/credentials/revoke.md b/content/rest/credentials/revoke.md index a3cfd2182575..93cd00da7284 100644 --- a/content/rest/credentials/revoke.md +++ b/content/rest/credentials/revoke.md @@ -7,6 +7,7 @@ intro: >- versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖 fpt: '*' ghec: '*' + ghes: '>=3.18' autogenerated: rest allowTitleToDifferFromFilename: true category: diff --git a/data/reusables/copilot/create-managed-settings.md b/data/reusables/copilot/create-managed-settings.md deleted file mode 100644 index 95b155c1862d..000000000000 --- a/data/reusables/copilot/create-managed-settings.md +++ /dev/null @@ -1,2 +0,0 @@ -1. In your enterprise's `.github-private` repository, navigate to the `.github/copilot/` directory. If you haven't set a `.github-private` repository as your enterprise's source of agent configuration, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents). -1. Create or edit the `{% data variables.copilot.managed_setting_file %}` file. (This file was previously named `settings.json`, which is also supported.) diff --git a/data/reusables/copilot/disable-bypass.md b/data/reusables/copilot/disable-bypass.md deleted file mode 100644 index f2984e2432c4..000000000000 --- a/data/reusables/copilot/disable-bypass.md +++ /dev/null @@ -1 +0,0 @@ -> [!NOTE] If you have a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} license, these commands may be blocked by an enterprise administrator. diff --git a/data/reusables/credentials/revoke-via-api.md b/data/reusables/credentials/revoke-via-api.md index 252167a8e13e..5a03e1fbfe1f 100644 --- a/data/reusables/credentials/revoke-via-api.md +++ b/data/reusables/credentials/revoke-via-api.md @@ -1,2 +1,2 @@ -{% ifversion fpt or ghec %} +{% ifversion fpt or ghec or ghes > 3.17 %} * If the token is owned by someone else, and the actual token value is known, **anyone** can submit a request to revoke it using the REST API. The API doesn't require authentication - anyone with the token value can submit it for revocation. See [AUTOTITLE](/rest/credentials/revoke?apiVersion=2022-11-28#revoke-a-list-of-credentials) in the REST API documentation.{% endif %} diff --git a/data/variables/copilot.yml b/data/variables/copilot.yml index 892964886ae6..04a26817dc47 100644 --- a/data/variables/copilot.yml +++ b/data/variables/copilot.yml @@ -254,6 +254,3 @@ copilot_workspace_short: 'Workspace' # BYOK copilot_byok_supported_features: '{% data variables.copilot.copilot_chat_short %}, {% data variables.copilot.copilot_cli_short %}, and {% data variables.product.prodname_vscode_shortname %}' - -## File for enterprise client management -managed_setting_file: 'managed-settings.json' diff --git a/src/github-apps/lib/config.json b/src/github-apps/lib/config.json index 8a89152da10d..0ce4b9c22f2c 100644 --- a/src/github-apps/lib/config.json +++ b/src/github-apps/lib/config.json @@ -60,5 +60,5 @@ "2022-11-28" ] }, - "sha": "7a0a14cf24805c7efd23fef351bfab80391ec8fb" + "sha": "5228aaa58229307d5c18092199d4d3b09050265a" } \ No newline at end of file diff --git a/src/rest/data/fpt-2022-11-28/billing.json b/src/rest/data/fpt-2022-11-28/billing.json index be90931a3448..df2fed2bf3d9 100644 --- a/src/rest/data/fpt-2022-11-28/billing.json +++ b/src/rest/data/fpt-2022-11-28/billing.json @@ -28,7 +28,7 @@ }, { "name": "per_page", - "description": "

The number of results per page (max 100).

", + "description": "

The number of results per page (max 10).

", "in": "query", "schema": { "type": "integer", @@ -61,7 +61,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets all budgets for an organization. The authenticated user must be an organization admin or billing manager.\nEach page returns up to 100 budgets.

", + "descriptionHTML": "

Gets all budgets for an organization. The authenticated user must be an organization admin or billing manager.\nEach page returns up to 10 budgets.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/fpt-2022-11-28/code-security.json b/src/rest/data/fpt-2022-11-28/code-security.json index 877312a18d23..cfa4eb24c6dc 100644 --- a/src/rest/data/fpt-2022-11-28/code-security.json +++ b/src/rest/data/fpt-2022-11-28/code-security.json @@ -145,10 +145,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -490,7 +487,8 @@ { "type": "string", "name": "description", - "description": "

A description of the code security configuration

" + "description": "

A description of the code security configuration

", + "isRequired": true }, { "type": "string", @@ -810,10 +808,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1272,10 +1267,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1677,10 +1669,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2338,10 +2327,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2972,10 +2958,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4017,10 +4000,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4366,7 +4346,8 @@ { "type": "string", "name": "description", - "description": "

A description of the code security configuration

" + "description": "

A description of the code security configuration

", + "isRequired": true }, { "type": "string", @@ -4762,10 +4743,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5216,10 +5194,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5736,10 +5711,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6465,10 +6437,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -7099,10 +7068,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -8110,10 +8076,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/fpt-2026-03-10/billing.json b/src/rest/data/fpt-2026-03-10/billing.json index be90931a3448..df2fed2bf3d9 100644 --- a/src/rest/data/fpt-2026-03-10/billing.json +++ b/src/rest/data/fpt-2026-03-10/billing.json @@ -28,7 +28,7 @@ }, { "name": "per_page", - "description": "

The number of results per page (max 100).

", + "description": "

The number of results per page (max 10).

", "in": "query", "schema": { "type": "integer", @@ -61,7 +61,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets all budgets for an organization. The authenticated user must be an organization admin or billing manager.\nEach page returns up to 100 budgets.

", + "descriptionHTML": "

Gets all budgets for an organization. The authenticated user must be an organization admin or billing manager.\nEach page returns up to 10 budgets.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/fpt-2026-03-10/code-security.json b/src/rest/data/fpt-2026-03-10/code-security.json index 877312a18d23..cfa4eb24c6dc 100644 --- a/src/rest/data/fpt-2026-03-10/code-security.json +++ b/src/rest/data/fpt-2026-03-10/code-security.json @@ -145,10 +145,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -490,7 +487,8 @@ { "type": "string", "name": "description", - "description": "

A description of the code security configuration

" + "description": "

A description of the code security configuration

", + "isRequired": true }, { "type": "string", @@ -810,10 +808,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1272,10 +1267,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1677,10 +1669,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2338,10 +2327,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2972,10 +2958,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4017,10 +4000,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4366,7 +4346,8 @@ { "type": "string", "name": "description", - "description": "

A description of the code security configuration

" + "description": "

A description of the code security configuration

", + "isRequired": true }, { "type": "string", @@ -4762,10 +4743,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5216,10 +5194,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5736,10 +5711,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6465,10 +6437,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -7099,10 +7068,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -8110,10 +8076,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghec-2022-11-28/billing.json b/src/rest/data/ghec-2022-11-28/billing.json index d17da217dd28..ba00a466e04a 100644 --- a/src/rest/data/ghec-2022-11-28/billing.json +++ b/src/rest/data/ghec-2022-11-28/billing.json @@ -213,7 +213,7 @@ }, { "name": "per_page", - "description": "

The number of results per page (max 100).

", + "description": "

The number of results per page (max 10).

", "in": "query", "schema": { "type": "integer", @@ -246,7 +246,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets all budgets for an enterprise. The authenticated user must be an enterprise admin or billing manager.\nEach page returns up to 100 budgets.

", + "descriptionHTML": "

Gets all budgets for an enterprise. The authenticated user must be an enterprise admin or billing manager.\nEach page returns up to 10 budgets.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2022-11-28/code-security.json b/src/rest/data/ghec-2022-11-28/code-security.json index 85619107072a..66d41f255715 100644 --- a/src/rest/data/ghec-2022-11-28/code-security.json +++ b/src/rest/data/ghec-2022-11-28/code-security.json @@ -145,10 +145,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -490,7 +487,8 @@ { "type": "string", "name": "description", - "description": "

A description of the code security configuration

" + "description": "

A description of the code security configuration

", + "isRequired": true }, { "type": "string", @@ -810,10 +808,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1272,10 +1267,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1677,10 +1669,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2338,10 +2327,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2972,10 +2958,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4017,10 +4000,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4366,7 +4346,8 @@ { "type": "string", "name": "description", - "description": "

A description of the code security configuration

" + "description": "

A description of the code security configuration

", + "isRequired": true }, { "type": "string", @@ -4762,10 +4743,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5216,10 +5194,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5736,10 +5711,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6465,10 +6437,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -7099,10 +7068,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -8110,10 +8076,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghec-2022-11-28/copilot.json b/src/rest/data/ghec-2022-11-28/copilot.json index 6b1ba6bb4e81..e10e80bbcc25 100644 --- a/src/rest/data/ghec-2022-11-28/copilot.json +++ b/src/rest/data/ghec-2022-11-28/copilot.json @@ -2708,7 +2708,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets the organization and repository configured as the source for custom agent definitions and Copilot CLI client settings in an enterprise.

\n

Custom agents are enterprise-defined AI agents stored as markdown files in a special repository.\nAn enterprise admin configures one organization as the \"source\" for custom agents and\nCopilot CLI client settings, and that org must have a repo named .github-private containing agent\ndefinitions in /agents/*.md, or enterprise-managed AI standards in copilot/managed-settings.json (with fallback to .github/copilot/settings.json). Learn more about configuring enterprise-managed AI standards for Copilot clients.

\n

Enterprise owners with read access to AI Controls can use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

", + "descriptionHTML": "

Gets the organization and repository configured as the source for custom agent definitions and Copilot CLI client settings in an enterprise.

\n

Custom agents are enterprise-defined AI agents stored as markdown files in a special repository.\nAn enterprise admin configures one organization as the \"source\" for custom agents and\nCopilot CLI client settings, and that org must have a repo named .github-private containing agent\ndefinitions in /agents/*.md, or enterprise-managed AI standards in .github/copilot/settings.json. Learn more about configuring enterprise-managed AI standards for Copilot clients.

\n

Enterprise owners with read access to AI Controls can use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2026-03-10/billing.json b/src/rest/data/ghec-2026-03-10/billing.json index d17da217dd28..ba00a466e04a 100644 --- a/src/rest/data/ghec-2026-03-10/billing.json +++ b/src/rest/data/ghec-2026-03-10/billing.json @@ -213,7 +213,7 @@ }, { "name": "per_page", - "description": "

The number of results per page (max 100).

", + "description": "

The number of results per page (max 10).

", "in": "query", "schema": { "type": "integer", @@ -246,7 +246,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets all budgets for an enterprise. The authenticated user must be an enterprise admin or billing manager.\nEach page returns up to 100 budgets.

", + "descriptionHTML": "

Gets all budgets for an enterprise. The authenticated user must be an enterprise admin or billing manager.\nEach page returns up to 10 budgets.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2026-03-10/code-security.json b/src/rest/data/ghec-2026-03-10/code-security.json index 85619107072a..66d41f255715 100644 --- a/src/rest/data/ghec-2026-03-10/code-security.json +++ b/src/rest/data/ghec-2026-03-10/code-security.json @@ -145,10 +145,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -490,7 +487,8 @@ { "type": "string", "name": "description", - "description": "

A description of the code security configuration

" + "description": "

A description of the code security configuration

", + "isRequired": true }, { "type": "string", @@ -810,10 +808,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1272,10 +1267,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1677,10 +1669,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2338,10 +2327,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2972,10 +2958,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4017,10 +4000,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4366,7 +4346,8 @@ { "type": "string", "name": "description", - "description": "

A description of the code security configuration

" + "description": "

A description of the code security configuration

", + "isRequired": true }, { "type": "string", @@ -4762,10 +4743,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5216,10 +5194,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5736,10 +5711,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6465,10 +6437,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -7099,10 +7068,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -8110,10 +8076,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghec-2026-03-10/copilot.json b/src/rest/data/ghec-2026-03-10/copilot.json index 4f5e65be6246..20cd6ffc6a1d 100644 --- a/src/rest/data/ghec-2026-03-10/copilot.json +++ b/src/rest/data/ghec-2026-03-10/copilot.json @@ -2705,7 +2705,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets the organization and repository configured as the source for custom agent definitions and Copilot CLI client settings in an enterprise.

\n

Custom agents are enterprise-defined AI agents stored as markdown files in a special repository.\nAn enterprise admin configures one organization as the \"source\" for custom agents and\nCopilot CLI client settings, and that org must have a repo named .github-private containing agent\ndefinitions in /agents/*.md, or enterprise-managed AI standards in copilot/managed-settings.json (with fallback to .github/copilot/settings.json). Learn more about configuring enterprise-managed AI standards for Copilot clients.

\n

Enterprise owners with read access to AI Controls can use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

", + "descriptionHTML": "

Gets the organization and repository configured as the source for custom agent definitions and Copilot CLI client settings in an enterprise.

\n

Custom agents are enterprise-defined AI agents stored as markdown files in a special repository.\nAn enterprise admin configures one organization as the \"source\" for custom agents and\nCopilot CLI client settings, and that org must have a repo named .github-private containing agent\ndefinitions in /agents/*.md, or enterprise-managed AI standards in .github/copilot/settings.json. Learn more about configuring enterprise-managed AI standards for Copilot clients.

\n

Enterprise owners with read access to AI Controls can use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:enterprise scope to use this endpoint.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghes-3.17-2022-11-28/code-security.json b/src/rest/data/ghes-3.17-2022-11-28/code-security.json index 4e00ef06ce9e..b04cb5bcc0a3 100644 --- a/src/rest/data/ghes-3.17-2022-11-28/code-security.json +++ b/src/rest/data/ghes-3.17-2022-11-28/code-security.json @@ -133,10 +133,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -643,10 +640,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1018,10 +1012,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1345,10 +1336,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1852,10 +1840,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2396,10 +2381,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -3354,10 +3336,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -3923,10 +3902,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4290,10 +4266,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4720,10 +4693,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5284,10 +5254,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5828,10 +5795,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6762,10 +6726,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghes-3.18-2022-11-28/code-security.json b/src/rest/data/ghes-3.18-2022-11-28/code-security.json index 29a2fcd9cb70..8ec33959074a 100644 --- a/src/rest/data/ghes-3.18-2022-11-28/code-security.json +++ b/src/rest/data/ghes-3.18-2022-11-28/code-security.json @@ -133,10 +133,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -643,10 +640,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1018,10 +1012,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1345,10 +1336,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1852,10 +1840,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2396,10 +2381,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -3354,10 +3336,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -3923,10 +3902,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4290,10 +4266,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4720,10 +4693,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5284,10 +5254,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5828,10 +5795,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6762,10 +6726,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghes-3.18-2022-11-28/credentials.json b/src/rest/data/ghes-3.18-2022-11-28/credentials.json new file mode 100644 index 000000000000..219df9f9e451 --- /dev/null +++ b/src/rest/data/ghes-3.18-2022-11-28/credentials.json @@ -0,0 +1,71 @@ +{ + "revoke": [ + { + "serverUrl": "http(s)://HOSTNAME/api/v3", + "verb": "post", + "requestPath": "/credentials/revoke", + "title": "Revoke a list of credentials", + "category": "credentials", + "subcategory": "revoke", + "parameters": [], + "bodyParameters": [ + { + "type": "array of strings", + "name": "credentials", + "description": "

A list of credentials to be revoked, up to 1000 per request.

", + "isRequired": true + } + ], + "descriptionHTML": "

Submit a list of credentials to be revoked. This endpoint is intended to revoke credentials the caller does not own and may have found exposed on GitHub.com or elsewhere. Credential owners will be notified of the revocation.

\n

This endpoint currently accepts the following credential types:

\n\n

To prevent abuse, this API is limited to 60 authenticated requests per hour and a max of 1000 tokens per API request.

", + "codeExamples": [ + { + "request": { + "contentType": "application/json", + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "credentials": [ + "ghp_1234567890abcdef1234567890abcdef12345678", + "github_pat_0A1B2C3D4E5F6G7H8I9J0K_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456", + "gho_1234567890abcdef1234567890abcdef12345678", + "ghu_1234567890abcdef1234567890abcdef12345678", + "ghr_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab" + ] + } + }, + "response": { + "statusCode": "202", + "contentType": "application/json", + "description": "

Accepted

", + "example": null, + "schema": { + "type": "object" + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "202", + "description": "

Accepted

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": false, + "serverToServer": false, + "fineGrainedPat": false, + "permissions": [], + "allowPermissionlessAccess": true + } + } + ] +} \ No newline at end of file diff --git a/src/rest/data/ghes-3.19-2022-11-28/code-security.json b/src/rest/data/ghes-3.19-2022-11-28/code-security.json index 4737d1cfa4bb..985f38da3ae1 100644 --- a/src/rest/data/ghes-3.19-2022-11-28/code-security.json +++ b/src/rest/data/ghes-3.19-2022-11-28/code-security.json @@ -133,10 +133,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -691,10 +688,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1082,10 +1076,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1425,10 +1416,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1973,10 +1961,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2536,10 +2521,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -3510,10 +3492,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4130,10 +4109,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4513,10 +4489,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4962,10 +4935,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5570,10 +5540,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6133,10 +6100,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -7083,10 +7047,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghes-3.19-2022-11-28/credentials.json b/src/rest/data/ghes-3.19-2022-11-28/credentials.json new file mode 100644 index 000000000000..219df9f9e451 --- /dev/null +++ b/src/rest/data/ghes-3.19-2022-11-28/credentials.json @@ -0,0 +1,71 @@ +{ + "revoke": [ + { + "serverUrl": "http(s)://HOSTNAME/api/v3", + "verb": "post", + "requestPath": "/credentials/revoke", + "title": "Revoke a list of credentials", + "category": "credentials", + "subcategory": "revoke", + "parameters": [], + "bodyParameters": [ + { + "type": "array of strings", + "name": "credentials", + "description": "

A list of credentials to be revoked, up to 1000 per request.

", + "isRequired": true + } + ], + "descriptionHTML": "

Submit a list of credentials to be revoked. This endpoint is intended to revoke credentials the caller does not own and may have found exposed on GitHub.com or elsewhere. Credential owners will be notified of the revocation.

\n

This endpoint currently accepts the following credential types:

\n\n

To prevent abuse, this API is limited to 60 authenticated requests per hour and a max of 1000 tokens per API request.

", + "codeExamples": [ + { + "request": { + "contentType": "application/json", + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "credentials": [ + "ghp_1234567890abcdef1234567890abcdef12345678", + "github_pat_0A1B2C3D4E5F6G7H8I9J0K_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456", + "gho_1234567890abcdef1234567890abcdef12345678", + "ghu_1234567890abcdef1234567890abcdef12345678", + "ghr_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab" + ] + } + }, + "response": { + "statusCode": "202", + "contentType": "application/json", + "description": "

Accepted

", + "example": null, + "schema": { + "type": "object" + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "202", + "description": "

Accepted

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": false, + "serverToServer": false, + "fineGrainedPat": false, + "permissions": [], + "allowPermissionlessAccess": true + } + } + ] +} \ No newline at end of file diff --git a/src/rest/data/ghes-3.20-2022-11-28/code-security.json b/src/rest/data/ghes-3.20-2022-11-28/code-security.json index bb072de78d43..e373c04e22a9 100644 --- a/src/rest/data/ghes-3.20-2022-11-28/code-security.json +++ b/src/rest/data/ghes-3.20-2022-11-28/code-security.json @@ -133,10 +133,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -691,10 +688,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1082,10 +1076,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1425,10 +1416,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1973,10 +1961,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2536,10 +2521,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -3510,10 +3492,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4130,10 +4109,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4513,10 +4489,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4962,10 +4935,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5570,10 +5540,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6133,10 +6100,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -7083,10 +7047,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghes-3.20-2022-11-28/credentials.json b/src/rest/data/ghes-3.20-2022-11-28/credentials.json new file mode 100644 index 000000000000..219df9f9e451 --- /dev/null +++ b/src/rest/data/ghes-3.20-2022-11-28/credentials.json @@ -0,0 +1,71 @@ +{ + "revoke": [ + { + "serverUrl": "http(s)://HOSTNAME/api/v3", + "verb": "post", + "requestPath": "/credentials/revoke", + "title": "Revoke a list of credentials", + "category": "credentials", + "subcategory": "revoke", + "parameters": [], + "bodyParameters": [ + { + "type": "array of strings", + "name": "credentials", + "description": "

A list of credentials to be revoked, up to 1000 per request.

", + "isRequired": true + } + ], + "descriptionHTML": "

Submit a list of credentials to be revoked. This endpoint is intended to revoke credentials the caller does not own and may have found exposed on GitHub.com or elsewhere. Credential owners will be notified of the revocation.

\n

This endpoint currently accepts the following credential types:

\n\n

To prevent abuse, this API is limited to 60 authenticated requests per hour and a max of 1000 tokens per API request.

", + "codeExamples": [ + { + "request": { + "contentType": "application/json", + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "credentials": [ + "ghp_1234567890abcdef1234567890abcdef12345678", + "github_pat_0A1B2C3D4E5F6G7H8I9J0K_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456", + "gho_1234567890abcdef1234567890abcdef12345678", + "ghu_1234567890abcdef1234567890abcdef12345678", + "ghr_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab" + ] + } + }, + "response": { + "statusCode": "202", + "contentType": "application/json", + "description": "

Accepted

", + "example": null, + "schema": { + "type": "object" + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "202", + "description": "

Accepted

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": false, + "serverToServer": false, + "fineGrainedPat": false, + "permissions": [], + "allowPermissionlessAccess": true + } + } + ] +} \ No newline at end of file diff --git a/src/rest/data/ghes-3.21-2022-11-28/code-security.json b/src/rest/data/ghes-3.21-2022-11-28/code-security.json index 54a32addc151..78e61e8e22ff 100644 --- a/src/rest/data/ghes-3.21-2022-11-28/code-security.json +++ b/src/rest/data/ghes-3.21-2022-11-28/code-security.json @@ -133,10 +133,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -691,10 +688,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1082,10 +1076,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1425,10 +1416,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1980,10 +1968,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2543,10 +2528,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -3517,10 +3499,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4137,10 +4116,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4520,10 +4496,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4969,10 +4942,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5584,10 +5554,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6147,10 +6114,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -7097,10 +7061,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghes-3.21-2022-11-28/credentials.json b/src/rest/data/ghes-3.21-2022-11-28/credentials.json new file mode 100644 index 000000000000..e117122b3fde --- /dev/null +++ b/src/rest/data/ghes-3.21-2022-11-28/credentials.json @@ -0,0 +1,71 @@ +{ + "revoke": [ + { + "serverUrl": "http(s)://HOSTNAME/api/v3", + "verb": "post", + "requestPath": "/credentials/revoke", + "title": "Revoke a list of credentials", + "category": "credentials", + "subcategory": "revoke", + "parameters": [], + "bodyParameters": [ + { + "type": "array of strings", + "name": "credentials", + "description": "

A list of credentials to be revoked, up to 1000 per request.

", + "isRequired": true + } + ], + "descriptionHTML": "

Submit a list of credentials to be revoked. This endpoint is intended to revoke credentials the caller does not own and may have found exposed on GitHub.com or elsewhere. Credential owners will be notified of the revocation.

\n

This endpoint currently accepts the following credential types:

\n\n

To prevent abuse, this API is limited to 60 authenticated requests per hour and a max of 1000 tokens per API request.

", + "codeExamples": [ + { + "request": { + "contentType": "application/json", + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "credentials": [ + "ghp_1234567890abcdef1234567890abcdef12345678", + "github_pat_0A1B2C3D4E5F6G7H8I9J0K_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456", + "gho_1234567890abcdef1234567890abcdef12345678", + "ghu_1234567890abcdef1234567890abcdef12345678", + "ghr_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab" + ] + } + }, + "response": { + "statusCode": "202", + "contentType": "application/json", + "description": "

Accepted

", + "example": null, + "schema": { + "type": "object" + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "202", + "description": "

Accepted

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": false, + "serverToServer": false, + "fineGrainedPat": false, + "permissions": [], + "allowPermissionlessAccess": true + } + } + ] +} \ No newline at end of file diff --git a/src/rest/data/ghes-3.21-2026-03-10/code-security.json b/src/rest/data/ghes-3.21-2026-03-10/code-security.json index 54a32addc151..78e61e8e22ff 100644 --- a/src/rest/data/ghes-3.21-2026-03-10/code-security.json +++ b/src/rest/data/ghes-3.21-2026-03-10/code-security.json @@ -133,10 +133,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -691,10 +688,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1082,10 +1076,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1425,10 +1416,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -1980,10 +1968,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -2543,10 +2528,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -3517,10 +3499,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4137,10 +4116,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4520,10 +4496,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -4969,10 +4942,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -5584,10 +5554,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -6147,10 +6114,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { @@ -7097,10 +7061,7 @@ ] }, "description": { - "type": [ - "string", - "null" - ], + "type": "string", "description": "A description of the code security configuration" }, "advanced_security": { diff --git a/src/rest/data/ghes-3.21-2026-03-10/credentials.json b/src/rest/data/ghes-3.21-2026-03-10/credentials.json new file mode 100644 index 000000000000..e117122b3fde --- /dev/null +++ b/src/rest/data/ghes-3.21-2026-03-10/credentials.json @@ -0,0 +1,71 @@ +{ + "revoke": [ + { + "serverUrl": "http(s)://HOSTNAME/api/v3", + "verb": "post", + "requestPath": "/credentials/revoke", + "title": "Revoke a list of credentials", + "category": "credentials", + "subcategory": "revoke", + "parameters": [], + "bodyParameters": [ + { + "type": "array of strings", + "name": "credentials", + "description": "

A list of credentials to be revoked, up to 1000 per request.

", + "isRequired": true + } + ], + "descriptionHTML": "

Submit a list of credentials to be revoked. This endpoint is intended to revoke credentials the caller does not own and may have found exposed on GitHub.com or elsewhere. Credential owners will be notified of the revocation.

\n

This endpoint currently accepts the following credential types:

\n\n

To prevent abuse, this API is limited to 60 authenticated requests per hour and a max of 1000 tokens per API request.

", + "codeExamples": [ + { + "request": { + "contentType": "application/json", + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "credentials": [ + "ghp_1234567890abcdef1234567890abcdef12345678", + "github_pat_0A1B2C3D4E5F6G7H8I9J0K_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456", + "gho_1234567890abcdef1234567890abcdef12345678", + "ghu_1234567890abcdef1234567890abcdef12345678", + "ghr_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab" + ] + } + }, + "response": { + "statusCode": "202", + "contentType": "application/json", + "description": "

Accepted

", + "example": null, + "schema": { + "type": "object" + } + } + } + ], + "statusCodes": [ + { + "httpStatusCode": "202", + "description": "

Accepted

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ], + "previews": [], + "progAccess": { + "userToServerRest": false, + "serverToServer": false, + "fineGrainedPat": false, + "permissions": [], + "allowPermissionlessAccess": true + } + } + ] +} \ No newline at end of file diff --git a/src/rest/lib/config.json b/src/rest/lib/config.json index 7c4673a81a64..3dede124ad4d 100644 --- a/src/rest/lib/config.json +++ b/src/rest/lib/config.json @@ -47,5 +47,5 @@ ] } }, - "sha": "7a0a14cf24805c7efd23fef351bfab80391ec8fb" + "sha": "5228aaa58229307d5c18092199d4d3b09050265a" } \ No newline at end of file diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json index 41fbabdbaad3..45f926d7d521 100644 --- a/src/webhooks/lib/config.json +++ b/src/webhooks/lib/config.json @@ -1,3 +1,3 @@ { - "sha": "7a0a14cf24805c7efd23fef351bfab80391ec8fb" + "sha": "5228aaa58229307d5c18092199d4d3b09050265a" } \ No newline at end of file