From d7481428703846d310738e90fa1cc8c2f56a28db Mon Sep 17 00:00:00 2001 From: docs-bot <77750099+docs-bot@users.noreply.github.com> Date: Mon, 5 Oct 2026 08:25:06 +0000 Subject: [PATCH 1/5] docs: update gh-stack content from source docs (#63654) Co-authored-by: github-actions[bot] Co-authored-by: Sameen Karim --- .../reference/stacked-prs-cli-commands.md | 39 ++++++++++++++++++- src/content-pipelines/state/gh-stack.sha | 2 +- 2 files changed, 39 insertions(+), 2 deletions(-) diff --git a/content/pull-requests/reference/stacked-prs-cli-commands.md b/content/pull-requests/reference/stacked-prs-cli-commands.md index 1aa14b17e040..01c445d637cd 100644 --- a/content/pull-requests/reference/stacked-prs-cli-commands.md +++ b/content/pull-requests/reference/stacked-prs-cli-commands.md @@ -19,7 +19,7 @@ The `gh stack` extension for {% data variables.product.prodname_cli %} creates a gh extension install github/gh-stack ``` -The extension requires {% data variables.product.prodname_cli %} (`gh`) version 2.0 or later. +The extension requires {% data variables.product.prodname_cli %} (`gh`) version 2.0 or later, and Git 2.36 or later. > [!NOTE] > The `gh stack` extension uses your {% data variables.product.prodname_cli %} authentication. If you have not authenticated yet, run `gh auth login`. @@ -63,6 +63,8 @@ Initializes a new stack locally. In interactive mode (no arguments), the command When you provide explicit branch names, existing branches are adopted automatically and any missing branches are created. The trunk defaults to the repository's default branch unless you override it with `--base`. +Branches checked out in other worktrees can be adopted. If the final branch is already checked out elsewhere, `init` leaves your current checkout unchanged and reports the owning worktree instead. + The command enables `git rerere` automatically, so that conflict resolutions are remembered across rebases. | Flag | Description | @@ -95,6 +97,8 @@ gh stack add [flags] [branch] For an existing stack, creates a new branch at the current HEAD, adds it to the top of the stack, and checks it out. You must run this command while on the topmost branch of a stack. If you do not provide a branch name, the command prompts for one. +If the branch name you provide is already checked out in another worktree, `add` adopts the existing branch without switching either checkout. The commit and stage shortcuts `-m`, `-A`, and `-u` are incompatible with that kind of adoption, and the command fails before staging anything or changing stack membership. + When you run the command interactively from a branch that is not part of a stack, `add` offers to initialize a new stack instead. The branch name you supply, or the auto-generated name, becomes the first layer. If you don't supply a name, the standard `init` prompts are used. You can optionally stage changes and create a commit as part of the `add` flow. When you provide `-m` without an explicit branch name, the branch name is generated automatically in date and slug format, such as `03-24-add_login`. @@ -166,6 +170,12 @@ Check out a stack by its stack number, a pull request number, a pull request URL gh stack checkout [ | | | ] ``` +| Flag | Description | +|------|-------------| +| `--print-path` | Print the target worktree's absolute path. Requires an explicit target and never prompts. | + +For a target that is checked out in another worktree, `--print-path` prints that worktree's path without changing either checkout. For a target that is not checked out anywhere, the command checks out the branch in the current worktree before printing its path. Without the flag, trying to check out a target that's occupied elsewhere is an error that includes a path diagnostic, rather than a successful switch. See [Navigation](#navigation) for details on the output contract. + A bare number is interpreted first as a stack or pull request number. These are repository-scoped identifiers shown in the {% data variables.product.github %} UI. If nothing matches the number, it is tried as a branch name. When you reference a remote stack, the command fetches the stack on {% data variables.product.github %}, pulls the branches, and sets up the stack locally. If the stack already exists locally and matches, the command switches to the branch. If the local and remote stacks have different compositions, you are prompted to resolve the conflict. @@ -217,6 +227,9 @@ The command checks these conditions before opening the interface: 1. No rebase is in progress. 1. No pull request in the stack is queued for merge. 1. Commit history must be linear, with no merge commits and no diverged branches. +1. Every worktree needed by the staged actions, and by the branches that survive the cascade, must be clean and free of other Git operations. + +Stack branches can be distributed across worktrees. Renames run in the branch's own worktree. Fold-down cherry-picks run in the receiving branch's worktree. Cascading rebases run each branch in its own worktree. A branch that isn't checked out anywhere uses the worktree you ran `modify` from, and inserted branches are created as refs without new worktrees. Dropped and folded branches, and their worktrees, are preserved. The trunk branch is only read, so unrelated or untouched source worktrees don't need to be clean. **Operations** @@ -241,6 +254,10 @@ If a rebase conflict occurs, you can either: * Resolve the conflicts, stage the files, then run `gh stack modify --continue`. * Run `gh stack modify --abort` to abort the operation and restore the stack to its previous state. +Resolve and stage conflicts in the worktree named in the conflict message, which may be a foreign fold receiver's worktree or a rebase owner's worktree rather than the one you ran `modify` from. Both `--continue` and `--abort` can be run from any linked worktree, because they use the recorded owner rather than your current checkout. Continuing resumes any remaining structural actions as well as remaining rebases. Aborting reverses renames in their own worktrees, restores only the refs that the operation touched, and deletes only the refs it created. If a restore or a journal or catalog save fails, the recovery state is retained so you can retry. + +Other worktrees are never switched to a different branch. The worktree you ran `modify` from returns to its original branch, including its new name if that branch was renamed, or to the nearest surviving branch if the original is gone. If that surviving branch is checked out elsewhere, your worktree instead keeps its preserved original branch, and the command reports the surviving branch's path. Any pending state used by `gh stack submit` is only consumed for the stack that was just modified. + **After modifying** If you have already created a stack of pull requests on {% data variables.product.github %}, run `gh stack submit` to push the updated branches and recreate the stack. The old stack is replaced automatically. @@ -399,6 +416,8 @@ If a rebase conflict occurs, the operation pauses and prints the conflicted file | `--remote ` | Remote to fetch from (defaults to the automatically detected remote) | | `--committer-date-is-author-date` | Set the committer date to the author date during the rebase. Alias: `--preserve-dates`. | +Date-preserving rebases explicitly use Git's merge backend, so the setting persists across conflicts. `--continue` reuses the native rebase settings that were saved when the rebase started, and doesn't resend start-only date options. + | Argument | Description | |----------|-------------| | `[branch]` | Target branch (defaults to the current branch) | @@ -543,6 +562,10 @@ Navigation commands move you between branches in the current stack without havin All navigation commands clamp to the bounds of the stack. Moving up from the top, or down from the bottom, does nothing and displays a message. +`up`, `down`, `top`, `bottom`, `trunk`, and `checkout` with an explicit target all support `--print-path`. For a target checked out in another worktree, the command prints that worktree's path without switching to it. For a target that isn't checked out anywhere, the command checks it out in the worktree you ran it from, then prints that worktree's path. If the target is already checked out in the current worktree, the command prints the current worktree's root. + +When you use `--print-path` successfully, standard output contains only the raw absolute path followed by a single newline. Diagnostics are written to standard error, and a failed or ambiguous target produces no standard output at all; `--print-path` never prompts. Without the flag, navigating to a branch that's checked out elsewhere fails and reports that branch's path. If you wrap `gh stack` in a shell function to `cd` into the printed path, check the command's exit status first, quote the path, and avoid `eval`. + ### `gh stack switch` Interactively switch to another branch in the stack. @@ -686,6 +709,20 @@ gh stack feedback gh stack feedback "Support for reordering branches" ``` +## Worktree support + +`gh stack` works across linked Git worktrees in the same clone. + +All linked worktrees share one `gh-stack` state directory and recovery journal, stored under the repository's common directory. Native Git state, such as `HEAD`, the index, and in-progress rebase or cherry-pick markers, stays local to each worktree. Mutating commands are serialized across the whole clone, but read-only commands such as `gh stack view` remain available while a mutation runs in another worktree. + +Nonconflicting legacy catalogs migrate to the current format automatically, and the original files are preserved. Catalogs with conflicting definitions require manual reconciliation. Complete any in-progress legacy recovery in its original worktree before migrating, and don't mix old and new catalog versions in the same clone. + +`gh stack rebase` and `gh stack sync` automatically update the branches of any affected worktree that is clean, meaning it has no uncommitted changes, no other Git operation in progress, and is otherwise unchanged. They block updates to worktrees that are dirty, busy, missing, or have changed unexpectedly. Neither command stashes your changes automatically, or creates or removes worktrees for you. + +For commands that share a recovery journal, `--continue` and `--abort` operate on the worktree recorded in the journal, not the worktree you run the command from. If recovery fails partway through, the operation's state is retained so you can retry. + +For repositories created with `git init --separate-git-dir`, `gh stack` supports invocation from the main worktree, and from linked worktrees that have an absolute or relative `core.worktree` backlink to the main worktree, including settings stored in the main worktree's `config.worktree` file. The one unsupported configuration is invoking `gh stack` from a linked worktree that has no backlink to the main worktree. If an operation requires access to that worktree and can't find it, the operation fails with guidance on how to proceed; worktrees unaffected by the missing backlink continue to work normally. `gh stack` never uses a Git administration directory as a checkout destination. + ## Environment variables | Variable | Values | Description | diff --git a/src/content-pipelines/state/gh-stack.sha b/src/content-pipelines/state/gh-stack.sha index 2cab52b4d5db..6171677f5339 100644 --- a/src/content-pipelines/state/gh-stack.sha +++ b/src/content-pipelines/state/gh-stack.sha @@ -1 +1 @@ -2bd699a544a09cb5c45a013d03416e0894b0454e +cb357d8d68f7e4f44247eb784eba9a1fc3710798 From 0e728d475115c6d76e0851c309af81a39a03812b Mon Sep 17 00:00:00 2001 From: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> Date: Mon, 5 Oct 2026 09:25:14 +0000 Subject: [PATCH 2/5] Reorder links to endpoints for external custom properties (#63649) --- .../sync-external-custom-properties.md | 23 ++++++++++++------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/content/organizations/managing-organization-settings/sync-external-custom-properties.md b/content/organizations/managing-organization-settings/sync-external-custom-properties.md index d58ed55af394..96dcb406d0ba 100644 --- a/content/organizations/managing-organization-settings/sync-external-custom-properties.md +++ b/content/organizations/managing-organization-settings/sync-external-custom-properties.md @@ -35,7 +35,7 @@ Each display name is scoped to a single {% data variables.product.prodname_githu Choose a name that will avoid conflicts and will help users identify custom properties from the external system. If you're publishing an app on behalf of a third-party system, you may want to respond to conflicts or allow users to choose their own display name as part of the setup flow on your system. -The display name must between 1 and 15 characters and contain only letters and numbers. For all requirements, see the [Register an app installation for external properties](/rest/orgs/custom-properties#register-an-app-installation-for-external-custom-properties) endpoint of the REST API. +The display name must be between 1 and 15 characters and contain only letters and numbers. For all requirements, see the [Register an app installation for external properties](/rest/orgs/custom-properties#register-an-app-installation-for-external-custom-properties) endpoint of the REST API. ## 2. Register a {% data variables.product.prodname_github_app %} @@ -83,14 +83,21 @@ The automation can run on a schedule or listen for events. The webhook you selec In the automation, the {% data variables.product.prodname_github_app %} must obtain an installation access token and use the token to send data from the external system to {% data variables.product.github %}'s external properties API endpoints. See [AUTOTITLE](/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app-installation). -See the following endpoints of the REST API. You will find information on request size limits and error codes that your automation should account for. +A typical flow would be to: -* [Register an app installation for external custom properties](/rest/orgs/custom-properties#register-an-app-installation-for-external-custom-properties) (the app must register its display name before it can update properties, unless an organization administrator is expected to do this) -* [Get registered app installations for external custom properties](/rest/orgs/custom-properties#get-registered-app-installations-for-external-custom-properties) -* [Get all external custom properties for a {% data variables.product.prodname_github_app %} installation in an organization](/rest/orgs/custom-properties#get-all-external-custom-properties-for-a-github-app-installation-in-an-organization) -* [Create or update external custom property values for organization repositories](/rest/orgs/custom-properties#create-or-update-external-custom-property-values-for-organization-repositories) -* [Create or update external custom property values for a property across organization repositories](/rest/orgs/custom-properties#create-or-update-external-custom-property-values-for-a-property-across-organization-repositories) -* [Remove all external custom property values for a property across all organization repositories](/rest/orgs/custom-properties#remove-all-external-custom-property-values-for-a-property-across-all-organization-repositories) +1. **Register the app installation** with a display name before updating properties, unless an organization administrator will register it. See [Register an app installation for external custom properties](/rest/orgs/custom-properties#register-an-app-installation-for-external-custom-properties). +1. **Create or update property values for one or more repositories**. See: + + * [Create or update external custom property values for organization repositories](/rest/orgs/custom-properties#create-or-update-external-custom-property-values-for-organization-repositories) + * [Create or update external custom property values for a property across organization repositories](/rest/orgs/custom-properties#create-or-update-external-custom-property-values-for-a-property-across-organization-repositories) + +You might also need to: + +* **Remove all values for one property across all organization repositories**. See [Remove all external custom property values for a property across all organization repositories](/rest/orgs/custom-properties#remove-all-external-custom-property-values-for-a-property-across-all-organization-repositories). +* **Get the external custom properties for the app installation** to verify the property definitions. See [Get all external custom properties for a {% data variables.product.prodname_github_app %} installation in an organization](/rest/orgs/custom-properties#get-all-external-custom-properties-for-a-github-app-installation-in-an-organization). +* **Get the registered app installations** to verify registration details. See [Get registered app installations for external custom properties](/rest/orgs/custom-properties#get-registered-app-installations-for-external-custom-properties). + +Check the linked REST API references for request size limits and error codes that your automation needs to handle. ## 4. Install the app From 5b5b0ca00d2a485c99d5276f8c8135ea2fb92ddd Mon Sep 17 00:00:00 2001 From: docs-bot <77750099+docs-bot@users.noreply.github.com> Date: Mon, 5 Oct 2026 09:40:18 +0000 Subject: [PATCH 3/5] Update OpenAPI Description (#63655) Co-authored-by: Sophie <29382425+sophietheking@users.noreply.github.com> --- src/github-apps/lib/config.json | 2 +- src/rest/data/fpt-2022-11-28/actions.json | 16 +++++----- .../data/fpt-2022-11-28/code-scanning.json | 8 ++--- src/rest/data/fpt-2022-11-28/pulls.json | 4 +++ src/rest/data/fpt-2026-03-10/actions.json | 16 +++++----- .../data/fpt-2026-03-10/code-scanning.json | 8 ++--- src/rest/data/fpt-2026-03-10/pulls.json | 4 +++ src/rest/data/ghec-2022-11-28/actions.json | 30 +++++++++---------- .../data/ghec-2022-11-28/code-scanning.json | 8 ++--- .../ghec-2022-11-28/enterprise-admin.json | 7 +++-- src/rest/data/ghec-2022-11-28/pulls.json | 4 +++ src/rest/data/ghec-2026-03-10/actions.json | 30 +++++++++---------- .../data/ghec-2026-03-10/code-scanning.json | 8 ++--- .../ghec-2026-03-10/enterprise-admin.json | 7 +++-- src/rest/data/ghec-2026-03-10/pulls.json | 4 +++ src/rest/data/ghes-3.18-2022-11-28/pulls.json | 4 +++ src/rest/data/ghes-3.19-2022-11-28/pulls.json | 4 +++ src/rest/data/ghes-3.20-2022-11-28/pulls.json | 4 +++ src/rest/data/ghes-3.21-2022-11-28/pulls.json | 4 +++ src/rest/data/ghes-3.21-2026-03-10/pulls.json | 4 +++ src/rest/data/ghes-3.22-2022-11-28/pulls.json | 4 +++ src/rest/data/ghes-3.22-2026-03-10/pulls.json | 4 +++ src/rest/lib/config.json | 2 +- src/webhooks/lib/config.json | 2 +- 24 files changed, 117 insertions(+), 71 deletions(-) diff --git a/src/github-apps/lib/config.json b/src/github-apps/lib/config.json index f7a83d2242e6..66b9d15e3951 100644 --- a/src/github-apps/lib/config.json +++ b/src/github-apps/lib/config.json @@ -60,5 +60,5 @@ "2022-11-28" ] }, - "sha": "2b78fb0c53617f188e45979ecefd83b521c5428a" + "sha": "7bdf5f00553689c2dabb027685cf29081093767e" } \ No newline at end of file diff --git a/src/rest/data/fpt-2022-11-28/actions.json b/src/rest/data/fpt-2022-11-28/actions.json index 1694c38ef7ca..49a26611c19b 100644 --- a/src/rest/data/fpt-2022-11-28/actions.json +++ b/src/rest/data/fpt-2022-11-28/actions.json @@ -6880,7 +6880,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets artifact and log retention settings for an organization.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an organization.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", "codeExamples": [ { "request": { @@ -6903,7 +6903,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -6966,11 +6966,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for an organization.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an organization.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

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

Gets artifact and log retention settings for a repository.

\n

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

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for a repository.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

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

", "codeExamples": [ { "request": { @@ -10480,7 +10480,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -10548,11 +10548,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for a repository.

\n

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

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for a repository.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

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

", "codeExamples": [ { "request": { diff --git a/src/rest/data/fpt-2022-11-28/code-scanning.json b/src/rest/data/fpt-2022-11-28/code-scanning.json index a42ea9e45a17..15e276fc1b3e 100644 --- a/src/rest/data/fpt-2022-11-28/code-scanning.json +++ b/src/rest/data/fpt-2022-11-28/code-scanning.json @@ -19,7 +19,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets the AI Scan setting stored on an organization.

\n

The response reports the value stored on the organization. Organization respects enterprise policy.

\n

The authenticated user must be an owner or security manager for the organization to use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

", + "descriptionHTML": "

Gets the AI Scan setting stored on an organization.

\n

The response reports the value stored on the organization. Organization respects enterprise policy.

\n

The authenticated user must be an owner or security manager for the organization to use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates the AI Scan setting stored on an organization.

\n

The organization respects the enterprise policy, so enabling is rejected when the enterprise disallows AI Scan.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

", + "descriptionHTML": "

Updates the AI Scan setting stored on an organization.

\n

The organization respects the enterprise policy, so enabling is rejected when the enterprise disallows AI Scan.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the security_events scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", + "descriptionHTML": "

Gets whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the security_events scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", + "descriptionHTML": "

Updates whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/fpt-2022-11-28/pulls.json b/src/rest/data/fpt-2022-11-28/pulls.json index 2654989c36e7..05d9677a07b5 100644 --- a/src/rest/data/fpt-2022-11-28/pulls.json +++ b/src/rest/data/fpt-2022-11-28/pulls.json @@ -18970,6 +18970,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/fpt-2026-03-10/actions.json b/src/rest/data/fpt-2026-03-10/actions.json index 1854f0020e35..20205df2db11 100644 --- a/src/rest/data/fpt-2026-03-10/actions.json +++ b/src/rest/data/fpt-2026-03-10/actions.json @@ -6880,7 +6880,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets artifact and log retention settings for an organization.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an organization.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", "codeExamples": [ { "request": { @@ -6903,7 +6903,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -6966,11 +6966,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for an organization.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an organization.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

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

Gets artifact and log retention settings for a repository.

\n

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

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for a repository.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

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

", "codeExamples": [ { "request": { @@ -10448,7 +10448,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -10516,11 +10516,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for a repository.

\n

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

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for a repository.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

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

", "codeExamples": [ { "request": { diff --git a/src/rest/data/fpt-2026-03-10/code-scanning.json b/src/rest/data/fpt-2026-03-10/code-scanning.json index 46d1bbfff9ed..568c5fb6a189 100644 --- a/src/rest/data/fpt-2026-03-10/code-scanning.json +++ b/src/rest/data/fpt-2026-03-10/code-scanning.json @@ -19,7 +19,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets the AI Scan setting stored on an organization.

\n

The response reports the value stored on the organization. Organization respects enterprise policy.

\n

The authenticated user must be an owner or security manager for the organization to use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

", + "descriptionHTML": "

Gets the AI Scan setting stored on an organization.

\n

The response reports the value stored on the organization. Organization respects enterprise policy.

\n

The authenticated user must be an owner or security manager for the organization to use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates the AI Scan setting stored on an organization.

\n

The organization respects the enterprise policy, so enabling is rejected when the enterprise disallows AI Scan.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

", + "descriptionHTML": "

Updates the AI Scan setting stored on an organization.

\n

The organization respects the enterprise policy, so enabling is rejected when the enterprise disallows AI Scan.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the security_events scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", + "descriptionHTML": "

Gets whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the security_events scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", + "descriptionHTML": "

Updates whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/fpt-2026-03-10/pulls.json b/src/rest/data/fpt-2026-03-10/pulls.json index 8bb8088b8df6..a6a27b4b405a 100644 --- a/src/rest/data/fpt-2026-03-10/pulls.json +++ b/src/rest/data/fpt-2026-03-10/pulls.json @@ -18275,6 +18275,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghec-2022-11-28/actions.json b/src/rest/data/ghec-2022-11-28/actions.json index 39b77ec2251d..82b2662db83b 100644 --- a/src/rest/data/ghec-2022-11-28/actions.json +++ b/src/rest/data/ghec-2022-11-28/actions.json @@ -9517,7 +9517,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets artifact and log retention settings for an enterprise.

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an enterprise.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

", "codeExamples": [ { "request": { @@ -9540,7 +9540,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -9558,7 +9558,7 @@ "statusCodes": [ { "httpStatusCode": "200", - "description": "

Successfully retrieved the artifact and log retention settings

" + "description": "

Successfully retrieved the retention settings for checks, workflow runs, commit statuses, artifacts, and logs

" }, { "httpStatusCode": "401", @@ -9599,11 +9599,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for an enterprise.

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an enterprise.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

", "codeExamples": [ { "request": { @@ -9619,14 +9619,14 @@ }, "response": { "statusCode": "204", - "description": "

Successfully updated the artifact and log retention settings

" + "description": "

Successfully updated the retention settings for checks, workflow runs, commit statuses, artifacts, and logs

" } } ], "statusCodes": [ { "httpStatusCode": "204", - "description": "

Successfully updated the artifact and log retention settings

" + "description": "

Successfully updated the retention settings for checks, workflow runs, commit statuses, artifacts, and logs

" }, { "httpStatusCode": "404", @@ -10947,7 +10947,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets artifact and log retention settings for an organization.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an organization.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", "codeExamples": [ { "request": { @@ -10970,7 +10970,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -11033,11 +11033,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for an organization.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an organization.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

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

Gets artifact and log retention settings for a repository.

\n

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

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for a repository.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

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

", "codeExamples": [ { "request": { @@ -14553,7 +14553,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -14621,11 +14621,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for a repository.

\n

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

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for a repository.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

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

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2022-11-28/code-scanning.json b/src/rest/data/ghec-2022-11-28/code-scanning.json index 043c01df044d..8fd4b2ecf82e 100644 --- a/src/rest/data/ghec-2022-11-28/code-scanning.json +++ b/src/rest/data/ghec-2022-11-28/code-scanning.json @@ -1451,7 +1451,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets the AI Scan setting stored on an organization.

\n

The response reports the value stored on the organization. Organization respects enterprise policy.

\n

The authenticated user must be an owner or security manager for the organization to use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

", + "descriptionHTML": "

Gets the AI Scan setting stored on an organization.

\n

The response reports the value stored on the organization. Organization respects enterprise policy.

\n

The authenticated user must be an owner or security manager for the organization to use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates the AI Scan setting stored on an organization.

\n

The organization respects the enterprise policy, so enabling is rejected when the enterprise disallows AI Scan.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

", + "descriptionHTML": "

Updates the AI Scan setting stored on an organization.

\n

The organization respects the enterprise policy, so enabling is rejected when the enterprise disallows AI Scan.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the security_events scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", + "descriptionHTML": "

Gets whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the security_events scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", + "descriptionHTML": "

Updates whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2022-11-28/enterprise-admin.json b/src/rest/data/ghec-2022-11-28/enterprise-admin.json index 93a15ffe0681..8523dc10f2ae 100644 --- a/src/rest/data/ghec-2022-11-28/enterprise-admin.json +++ b/src/rest/data/ghec-2022-11-28/enterprise-admin.json @@ -2747,17 +2747,18 @@ ], "bodyParameters": [ { - "type": "string", + "type": "integer or string", "name": "credential_id", - "description": "

The SHA-256 fingerprint of the user-owned SSH authentication key to authorize.

", + "description": "

The token ID of the personal access token (classic) to authorize.

", "isRequired": true }, { "type": "string", "name": "credential_type", - "description": "", + "description": "

The type of credential to authorize.

", "isRequired": true, "enum": [ + "classic_pat", "ssh_key" ] }, diff --git a/src/rest/data/ghec-2022-11-28/pulls.json b/src/rest/data/ghec-2022-11-28/pulls.json index d2a660bed669..63e5bb1c29f2 100644 --- a/src/rest/data/ghec-2022-11-28/pulls.json +++ b/src/rest/data/ghec-2022-11-28/pulls.json @@ -18970,6 +18970,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghec-2026-03-10/actions.json b/src/rest/data/ghec-2026-03-10/actions.json index 6d9efc9a6ccf..34fc8df7debb 100644 --- a/src/rest/data/ghec-2026-03-10/actions.json +++ b/src/rest/data/ghec-2026-03-10/actions.json @@ -9517,7 +9517,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets artifact and log retention settings for an enterprise.

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an enterprise.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

", "codeExamples": [ { "request": { @@ -9540,7 +9540,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -9558,7 +9558,7 @@ "statusCodes": [ { "httpStatusCode": "200", - "description": "

Successfully retrieved the artifact and log retention settings

" + "description": "

Successfully retrieved the retention settings for checks, workflow runs, commit statuses, artifacts, and logs

" }, { "httpStatusCode": "401", @@ -9599,11 +9599,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for an enterprise.

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an enterprise.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

", "codeExamples": [ { "request": { @@ -9619,14 +9619,14 @@ }, "response": { "statusCode": "204", - "description": "

Successfully updated the artifact and log retention settings

" + "description": "

Successfully updated the retention settings for checks, workflow runs, commit statuses, artifacts, and logs

" } } ], "statusCodes": [ { "httpStatusCode": "204", - "description": "

Successfully updated the artifact and log retention settings

" + "description": "

Successfully updated the retention settings for checks, workflow runs, commit statuses, artifacts, and logs

" }, { "httpStatusCode": "404", @@ -10947,7 +10947,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Gets artifact and log retention settings for an organization.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an organization.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", "codeExamples": [ { "request": { @@ -10970,7 +10970,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -11033,11 +11033,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for an organization.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for an organization.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope or the \"Actions policies\" fine-grained permission to use this endpoint.

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

Gets artifact and log retention settings for a repository.

\n

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

", + "descriptionHTML": "

Gets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for a repository.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

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

", "codeExamples": [ { "request": { @@ -14521,7 +14521,7 @@ "properties": { "days": { "type": "integer", - "description": "The number of days artifacts and logs are retained" + "description": "The number of days checks, workflow runs, commit statuses, artifacts, and logs are retained" }, "maximum_allowed_days": { "type": "integer", @@ -14589,11 +14589,11 @@ { "type": "integer", "name": "days", - "description": "

The number of days to retain artifacts and logs

", + "description": "

The number of days to retain checks, workflow runs, commit statuses, artifacts, and logs

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

Sets artifact and log retention settings for a repository.

\n

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

", + "descriptionHTML": "

Sets retention settings for checks, workflow runs, commit statuses, artifacts, and logs for a repository.

\n

Checks include check suites, check runs, and check annotations. These settings also apply to checks and commit statuses created by third-party integrations, and are not limited to data created by GitHub Actions.

\n

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

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2026-03-10/code-scanning.json b/src/rest/data/ghec-2026-03-10/code-scanning.json index 055ae504b602..05cb67851fbe 100644 --- a/src/rest/data/ghec-2026-03-10/code-scanning.json +++ b/src/rest/data/ghec-2026-03-10/code-scanning.json @@ -1451,7 +1451,7 @@ } ], "bodyParameters": [], - "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets the AI Scan setting stored on an organization.

\n

The response reports the value stored on the organization. Organization respects enterprise policy.

\n

The authenticated user must be an owner or security manager for the organization to use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

", + "descriptionHTML": "

Gets the AI Scan setting stored on an organization.

\n

The response reports the value stored on the organization. Organization respects enterprise policy.

\n

The authenticated user must be an owner or security manager for the organization to use this endpoint.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates the AI Scan setting stored on an organization.

\n

The organization respects the enterprise policy, so enabling is rejected when the enterprise disallows AI Scan.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

", + "descriptionHTML": "

Updates the AI Scan setting stored on an organization.

\n

The organization respects the enterprise policy, so enabling is rejected when the enterprise disallows AI Scan.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org, repo, or write:org scope to use this endpoint. Organization owners can use admin:org or repo; security managers need write:org.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the security_events scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", + "descriptionHTML": "

Gets whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the security_events scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

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

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", + "descriptionHTML": "

Updates whether AI Scan is enabled for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with private or public repositories, or the public_repo scope to use this endpoint with only public repositories.

", "codeExamples": [ { "request": { diff --git a/src/rest/data/ghec-2026-03-10/enterprise-admin.json b/src/rest/data/ghec-2026-03-10/enterprise-admin.json index 93a15ffe0681..8523dc10f2ae 100644 --- a/src/rest/data/ghec-2026-03-10/enterprise-admin.json +++ b/src/rest/data/ghec-2026-03-10/enterprise-admin.json @@ -2747,17 +2747,18 @@ ], "bodyParameters": [ { - "type": "string", + "type": "integer or string", "name": "credential_id", - "description": "

The SHA-256 fingerprint of the user-owned SSH authentication key to authorize.

", + "description": "

The token ID of the personal access token (classic) to authorize.

", "isRequired": true }, { "type": "string", "name": "credential_type", - "description": "", + "description": "

The type of credential to authorize.

", "isRequired": true, "enum": [ + "classic_pat", "ssh_key" ] }, diff --git a/src/rest/data/ghec-2026-03-10/pulls.json b/src/rest/data/ghec-2026-03-10/pulls.json index 51942c76cfd8..812c4a434c97 100644 --- a/src/rest/data/ghec-2026-03-10/pulls.json +++ b/src/rest/data/ghec-2026-03-10/pulls.json @@ -18275,6 +18275,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghes-3.18-2022-11-28/pulls.json b/src/rest/data/ghes-3.18-2022-11-28/pulls.json index bdec2dba4eb4..7b6d10c5d2c1 100644 --- a/src/rest/data/ghes-3.18-2022-11-28/pulls.json +++ b/src/rest/data/ghes-3.18-2022-11-28/pulls.json @@ -17629,6 +17629,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghes-3.19-2022-11-28/pulls.json b/src/rest/data/ghes-3.19-2022-11-28/pulls.json index 79195464c0b3..fbba5512dd42 100644 --- a/src/rest/data/ghes-3.19-2022-11-28/pulls.json +++ b/src/rest/data/ghes-3.19-2022-11-28/pulls.json @@ -17629,6 +17629,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghes-3.20-2022-11-28/pulls.json b/src/rest/data/ghes-3.20-2022-11-28/pulls.json index a1e35acd06f3..2b41f5f031da 100644 --- a/src/rest/data/ghes-3.20-2022-11-28/pulls.json +++ b/src/rest/data/ghes-3.20-2022-11-28/pulls.json @@ -17629,6 +17629,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghes-3.21-2022-11-28/pulls.json b/src/rest/data/ghes-3.21-2022-11-28/pulls.json index 9be47664a051..9decd5955507 100644 --- a/src/rest/data/ghes-3.21-2022-11-28/pulls.json +++ b/src/rest/data/ghes-3.21-2022-11-28/pulls.json @@ -17629,6 +17629,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghes-3.21-2026-03-10/pulls.json b/src/rest/data/ghes-3.21-2026-03-10/pulls.json index c11563988b9e..f2d173d9b45c 100644 --- a/src/rest/data/ghes-3.21-2026-03-10/pulls.json +++ b/src/rest/data/ghes-3.21-2026-03-10/pulls.json @@ -16934,6 +16934,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghes-3.22-2022-11-28/pulls.json b/src/rest/data/ghes-3.22-2022-11-28/pulls.json index 09ac8fecd8ae..6d1d82b29263 100644 --- a/src/rest/data/ghes-3.22-2022-11-28/pulls.json +++ b/src/rest/data/ghes-3.22-2022-11-28/pulls.json @@ -17638,6 +17638,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/data/ghes-3.22-2026-03-10/pulls.json b/src/rest/data/ghes-3.22-2026-03-10/pulls.json index a1a4ffa00a5e..125a103b1343 100644 --- a/src/rest/data/ghes-3.22-2026-03-10/pulls.json +++ b/src/rest/data/ghes-3.22-2026-03-10/pulls.json @@ -16943,6 +16943,10 @@ "httpStatusCode": "200", "description": "

OK

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

Not modified

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

Resource not found

" diff --git a/src/rest/lib/config.json b/src/rest/lib/config.json index 4f0093549e05..549825512a4b 100644 --- a/src/rest/lib/config.json +++ b/src/rest/lib/config.json @@ -48,5 +48,5 @@ ] } }, - "sha": "2b78fb0c53617f188e45979ecefd83b521c5428a" + "sha": "7bdf5f00553689c2dabb027685cf29081093767e" } \ No newline at end of file diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json index 3d5480812f35..4ce5305d67fb 100644 --- a/src/webhooks/lib/config.json +++ b/src/webhooks/lib/config.json @@ -1,3 +1,3 @@ { - "sha": "2b78fb0c53617f188e45979ecefd83b521c5428a" + "sha": "7bdf5f00553689c2dabb027685cf29081093767e" } \ No newline at end of file From dd7e864b020676895e9e45774b0d24a231f105bc Mon Sep 17 00:00:00 2001 From: Nhu Do Date: Mon, 5 Oct 2026 13:14:16 +0000 Subject: [PATCH 4/5] Update Auto model selection docs (#63629) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- data/tables/copilot/auto-model-selection.yml | 30 ++++++++------------ 1 file changed, 12 insertions(+), 18 deletions(-) diff --git a/data/tables/copilot/auto-model-selection.yml b/data/tables/copilot/auto-model-selection.yml index 4a114fba8990..b41ae4bc35ba 100644 --- a/data/tables/copilot/auto-model-selection.yml +++ b/data/tables/copilot/auto-model-selection.yml @@ -20,18 +20,6 @@ # OpenAI -- name: GPT-5.4 - cloud_agent: false - chat: true - cli: false - app: false - -- name: GPT-5.5 - cloud_agent: true - chat: true - cli: true - app: true - - name: GPT-5.6 Luna cloud_agent: true chat: true @@ -68,6 +56,12 @@ cli: true app: true +- name: GPT-6.1 Sol + cloud_agent: true + chat: true + cli: true + app: true + # Anthropic - name: Claude Haiku 4.5 cloud_agent: true @@ -93,20 +87,20 @@ cli: true app: true -- name: Claude Sonnet 4.6 - cloud_agent: false +- name: Claude Sonnet 5 + cloud_agent: true chat: true - cli: false - app: false + cli: true + app: true -- name: Claude Sonnet 5 +- name: Claude Sonnet 5.5 cloud_agent: true chat: true cli: true app: true # Google -- name: Gemini 3.7 Flash +- name: Gemini 3.8 Flash cloud_agent: true chat: true cli: true From 365f06636db8be7df6dfff70545c7bac85a5e9de Mon Sep 17 00:00:00 2001 From: "Hector A." Date: Mon, 5 Oct 2026 14:21:02 +0000 Subject: [PATCH 5/5] RestCodeSamples: swap FormControl and Select to Primer Brand (#63651) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- src/rest/components/RestCodeSamples.tsx | 5 +++-- src/rest/tests/rendering.ts | 20 ++++++++++++++++++++ 2 files changed, 23 insertions(+), 2 deletions(-) diff --git a/src/rest/components/RestCodeSamples.tsx b/src/rest/components/RestCodeSamples.tsx index 07148c2753a4..ecc1aa82ab31 100644 --- a/src/rest/components/RestCodeSamples.tsx +++ b/src/rest/components/RestCodeSamples.tsx @@ -1,5 +1,6 @@ import React, { useState, useEffect, useRef, FormEvent } from 'react' -import { FormControl, IconButton, Select, SegmentedControl } from '@primer/react' +import { IconButton, SegmentedControl } from '@primer/react' +import { FormControl, Select } from '@primer/react-brand' import { CheckIcon, CopyIcon, InfoIcon } from '@primer/octicons-react' import { announce } from '@primer/live-region-element' import Cookies from '@/frame/components/lib/cookies' @@ -137,7 +138,7 @@ export function RestCodeSamples({ operation, slug, heading }: Props) { {!isSingleExample && (
- + Select the example type