From 7b168cc4224b42047ab678ef334da13064ac39fd Mon Sep 17 00:00:00 2001 From: docs-bot <77750099+docs-bot@users.noreply.github.com> Date: Mon, 2 Nov 2026 10:10:50 +0000 Subject: [PATCH 1/2] Update OpenAPI Description (#64495) Co-authored-by: subatoi <32935794+subatoi@users.noreply.github.com> --- src/github-apps/lib/config.json | 2 +- src/rest/data/fpt-2022-11-28/users.json | 4 ++-- src/rest/data/fpt-2026-03-10/users.json | 4 ++-- src/rest/data/ghec-2022-11-28/users.json | 4 ++-- src/rest/data/ghec-2026-03-10/users.json | 4 ++-- src/rest/data/ghes-3.18-2022-11-28/users.json | 4 ++-- src/rest/data/ghes-3.19-2022-11-28/users.json | 4 ++-- src/rest/data/ghes-3.20-2022-11-28/users.json | 4 ++-- src/rest/data/ghes-3.21-2022-11-28/users.json | 4 ++-- src/rest/data/ghes-3.21-2026-03-10/users.json | 4 ++-- src/rest/data/ghes-3.22-2022-11-28/users.json | 4 ++-- src/rest/data/ghes-3.22-2026-03-10/users.json | 4 ++-- src/rest/lib/config.json | 2 +- src/webhooks/lib/config.json | 2 +- 14 files changed, 25 insertions(+), 25 deletions(-) diff --git a/src/github-apps/lib/config.json b/src/github-apps/lib/config.json index ccac9357558d..84c651f6580a 100644 --- a/src/github-apps/lib/config.json +++ b/src/github-apps/lib/config.json @@ -60,5 +60,5 @@ "2022-11-28" ] }, - "sha": "c66e298030d4070b70a569dcd4268b3a041b5380" + "sha": "320307e220815d528224ca891cf8a9e3c0243678" } \ No newline at end of file diff --git a/src/rest/data/fpt-2022-11-28/users.json b/src/rest/data/fpt-2022-11-28/users.json index e2ec029da94f..d7c69a661817 100644 --- a/src/rest/data/fpt-2022-11-28/users.json +++ b/src/rest/data/fpt-2022-11-28/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -5230,7 +5230,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/fpt-2026-03-10/users.json b/src/rest/data/fpt-2026-03-10/users.json index 07cca1303104..d8705b64fbd4 100644 --- a/src/rest/data/fpt-2026-03-10/users.json +++ b/src/rest/data/fpt-2026-03-10/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -5192,7 +5192,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2022-11-28/users.json b/src/rest/data/ghec-2022-11-28/users.json index 903dc93eee88..03976df1805d 100644 --- a/src/rest/data/ghec-2022-11-28/users.json +++ b/src/rest/data/ghec-2022-11-28/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -5230,7 +5230,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2026-03-10/users.json b/src/rest/data/ghec-2026-03-10/users.json index bb0ee16d834a..b834fbfb3d2d 100644 --- a/src/rest/data/ghec-2026-03-10/users.json +++ b/src/rest/data/ghec-2026-03-10/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -5192,7 +5192,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghes-3.18-2022-11-28/users.json b/src/rest/data/ghes-3.18-2022-11-28/users.json index 81710b55b75c..a81f2b00fbec 100644 --- a/src/rest/data/ghes-3.18-2022-11-28/users.json +++ b/src/rest/data/ghes-3.18-2022-11-28/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -3959,7 +3959,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghes-3.19-2022-11-28/users.json b/src/rest/data/ghes-3.19-2022-11-28/users.json index 7744ec554fcb..5fc8ae5f2bee 100644 --- a/src/rest/data/ghes-3.19-2022-11-28/users.json +++ b/src/rest/data/ghes-3.19-2022-11-28/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -3959,7 +3959,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghes-3.20-2022-11-28/users.json b/src/rest/data/ghes-3.20-2022-11-28/users.json index 3f1b47ef5271..2f914f6a8b4f 100644 --- a/src/rest/data/ghes-3.20-2022-11-28/users.json +++ b/src/rest/data/ghes-3.20-2022-11-28/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -3959,7 +3959,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghes-3.21-2022-11-28/users.json b/src/rest/data/ghes-3.21-2022-11-28/users.json index 1e48ff81f3db..77116ea5c151 100644 --- a/src/rest/data/ghes-3.21-2022-11-28/users.json +++ b/src/rest/data/ghes-3.21-2022-11-28/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -3959,7 +3959,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghes-3.21-2026-03-10/users.json b/src/rest/data/ghes-3.21-2026-03-10/users.json index 1e48ff81f3db..77116ea5c151 100644 --- a/src/rest/data/ghes-3.21-2026-03-10/users.json +++ b/src/rest/data/ghes-3.21-2026-03-10/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -3959,7 +3959,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghes-3.22-2022-11-28/users.json b/src/rest/data/ghes-3.22-2022-11-28/users.json index e8be72ec5710..be2b4d704a3e 100644 --- a/src/rest/data/ghes-3.22-2022-11-28/users.json +++ b/src/rest/data/ghes-3.22-2022-11-28/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -3959,7 +3959,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghes-3.22-2026-03-10/users.json b/src/rest/data/ghes-3.22-2026-03-10/users.json index e8be72ec5710..be2b4d704a3e 100644 --- a/src/rest/data/ghes-3.22-2026-03-10/users.json +++ b/src/rest/data/ghes-3.22-2026-03-10/users.json @@ -9,7 +9,7 @@ "subcategory": "users", "parameters": [], "bodyParameters": [], - "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

", + "descriptionHTML": "

OAuth app tokens and personal access tokens (classic) need the read:user scope, or the broader user scope, for this endpoint to return the private user response. The private user response includes additional fields such as private_gists, total_private_repos, owned_private_repos, disk_usage, collaborators, and two_factor_authentication. Tokens without these scopes receive the public user response.

\n

The private and public user response types are unrelated to the private profile setting. A token without scopes still authenticates as the token's owner, so values subject to private profile visibility, such as followers and following, may differ from an unauthenticated response.

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { @@ -3959,7 +3959,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

", + "descriptionHTML": "

Lists all of your email addresses, and specifies which one is visible\nto the public.

\n

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

\n

For enterprise-managed users, if their email is unverified, this endpoint will return a placeholder email in the format email+shortcode@domain.com instead of their actual email. This placeholder email may cause issues with some third-party apps. Once the user has verified their email address, the endpoint will return their real email.

", "codeExamples": [ { "request": { diff --git a/src/rest/lib/config.json b/src/rest/lib/config.json index 25b992fbb62f..3ca92bdc1aff 100644 --- a/src/rest/lib/config.json +++ b/src/rest/lib/config.json @@ -48,5 +48,5 @@ ] } }, - "sha": "c66e298030d4070b70a569dcd4268b3a041b5380" + "sha": "320307e220815d528224ca891cf8a9e3c0243678" } \ No newline at end of file diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json index 512504820282..4f03bab12b98 100644 --- a/src/webhooks/lib/config.json +++ b/src/webhooks/lib/config.json @@ -1,3 +1,3 @@ { - "sha": "c66e298030d4070b70a569dcd4268b3a041b5380" + "sha": "320307e220815d528224ca891cf8a9e3c0243678" } \ No newline at end of file From 4e75f08f8252bad510c1110f27ecd287a4dd36d8 Mon Sep 17 00:00:00 2001 From: "Steven B." <4163156+appatalks@users.noreply.github.com> Date: Mon, 2 Nov 2026 10:13:02 +0000 Subject: [PATCH 2/2] Clarify scheduled cluster rebalancing scope (#64479) Co-authored-by: Copilot Co-authored-by: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> --- .../configuring-clustering/rebalancing-cluster-workloads.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/rebalancing-cluster-workloads.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/rebalancing-cluster-workloads.md index 91690d079bf3..2c2a75715b77 100644 --- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/rebalancing-cluster-workloads.md +++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/rebalancing-cluster-workloads.md @@ -63,8 +63,7 @@ After you determine which jobs are unbalanced across your cluster's nodes, you c You can schedule rebalancing of jobs on your cluster by setting and applying configuration values for {% data variables.location.product_location %}. -> [!NOTE] -> Currently, you can only schedule reallocation of jobs for the HTTP server, `github-unicorn`. +By default, scheduled rebalancing considers all eligible jobs, including `github-unicorn` and other eligible services. You can apply a job filter with `-j`. 1. To configure automatic, hourly balancing of jobs, run the following command.