feat: .actions.downloadWorkflowRunAttemptLogs(), .actions.getWorkflowRunAttempt(), .repos.generateReleaseNotes(), .checks.rerequestRun(). Graduate nebula, zzzax, switcheroo, baptiste previews. Removes defunkt /repos/{owner}/{repo}/actions/runs/{run_id}/retry endpoint. Renames methods to have consistent AuthenticatedUser() suffix, deprecates previous method names

docs/actions/downloadWorkflowRunAttemptLogs.md

@@ -0,0 +1,55 @@
+---
+name: Download workflow run attempt logs
+example: octokit.rest.actions.downloadWorkflowRunAttemptLogs({ owner, repo, attempt_num, attempt_number })
+route: GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs
+scope: actions
+type: API method
+---
+
+# Download workflow run attempt logs
+
+Gets a redirect URL to download an archive of log files for a specific workflow run attempt. This link expires after
+1 minute. Look for `Location:` in the response header to find the URL for the download. Anyone with read access to
+the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.
+GitHub Apps must have the `actions:read` permission to use this endpoint.
+
+```js
+octokit.rest.actions.downloadWorkflowRunAttemptLogs({
+  owner,
+  repo,
+  attempt_num,
+  attempt_number,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>owner</td><td>yes</td><td>
+
+</td></tr>
+<tr><td>repo</td><td>yes</td><td>
+
+</td></tr>
+<tr><td>attempt_num</td><td>yes</td><td>
+
+The attempt number of the workflow run.
+
+</td></tr>
+<tr><td>attempt_number</td><td>yes</td><td>
+
+The attempt number of the workflow run.
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#download-workflow-run-attempt-logs).

docs/actions/getWorkflowRunAttempt.md

@@ -0,0 +1,55 @@
+---
+name: Get a workflow run attempt
+example: octokit.rest.actions.getWorkflowRunAttempt({ owner, repo, run_id, attempt_number })
+route: GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}
+scope: actions
+type: API method
+---
+
+# Get a workflow run attempt
+
+Gets a specific workflow run attempt. Anyone with read access to the repository
+can use this endpoint. If the repository is private you must use an access token
+with the `repo` scope. GitHub Apps must have the `actions:read` permission to
+use this endpoint.
+
+```js
+octokit.rest.actions.getWorkflowRunAttempt({
+  owner,
+  repo,
+  run_id,
+  attempt_number,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>owner</td><td>yes</td><td>
+
+</td></tr>
+<tr><td>repo</td><td>yes</td><td>
+
+</td></tr>
+<tr><td>run_id</td><td>yes</td><td>
+
+The id of the workflow run.
+
+</td></tr>
+<tr><td>attempt_number</td><td>yes</td><td>
+
+The attempt number of the workflow run.
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#get-a-workflow-run-attempt).

docs/apps/addRepoToInstallation.md

@@ -8,6 +8,8 @@ type: API method
 
 # Add a repository to an app installation
 
+**Deprecated:** This method has been renamed to apps.addRepoToInstallationForAuthenticatedUser
+
 Add a single repository to an installation. The authenticated user must have admin access to the repository.
 
 You must use a personal access token (which you can create via the [command line](https://docs.github.com/github/authenticating-to-github/creating-a-personal-access-token) or [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication)) to access this endpoint.

docs/apps/addRepoToInstallationForAuthenticatedUser.md

@@ -0,0 +1,44 @@
+---
+name: Add a repository to an app installation
+example: octokit.rest.apps.addRepoToInstallationForAuthenticatedUser({ installation_id, repository_id })
+route: PUT /user/installations/{installation_id}/repositories/{repository_id}
+scope: apps
+type: API method
+---
+
+# Add a repository to an app installation
+
+Add a single repository to an installation. The authenticated user must have admin access to the repository.
+
+You must use a personal access token (which you can create via the [command line](https://docs.github.com/github/authenticating-to-github/creating-a-personal-access-token) or [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication)) to access this endpoint.
+
+```js
+octokit.rest.apps.addRepoToInstallationForAuthenticatedUser({
+  installation_id,
+  repository_id,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>installation_id</td><td>yes</td><td>
+
+installation_id parameter
+
+</td></tr>
+<tr><td>repository_id</td><td>yes</td><td>
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/apps#add-a-repository-to-an-app-installation).

docs/apps/removeRepoFromInstallation.md

@@ -8,6 +8,8 @@ type: API method
 
 # Remove a repository from an app installation
 
+**Deprecated:** This method has been renamed to apps.removeRepoFromInstallationForAuthenticatedUser
+
 Remove a single repository from an installation. The authenticated user must have admin access to the repository.
 
 You must use a personal access token (which you can create via the [command line](https://docs.github.com/github/authenticating-to-github/creating-a-personal-access-token) or [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication)) to access this endpoint.

docs/apps/removeRepoFromInstallationForAuthenticatedUser.md

@@ -0,0 +1,44 @@
+---
+name: Remove a repository from an app installation
+example: octokit.rest.apps.removeRepoFromInstallationForAuthenticatedUser({ installation_id, repository_id })
+route: DELETE /user/installations/{installation_id}/repositories/{repository_id}
+scope: apps
+type: API method
+---
+
+# Remove a repository from an app installation
+
+Remove a single repository from an installation. The authenticated user must have admin access to the repository.
+
+You must use a personal access token (which you can create via the [command line](https://docs.github.com/github/authenticating-to-github/creating-a-personal-access-token) or [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication)) to access this endpoint.
+
+```js
+octokit.rest.apps.removeRepoFromInstallationForAuthenticatedUser({
+  installation_id,
+  repository_id,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>installation_id</td><td>yes</td><td>
+
+installation_id parameter
+
+</td></tr>
+<tr><td>repository_id</td><td>yes</td><td>
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/apps#remove-a-repository-from-an-app-installation).

docs/checks/rerequestRun.md

@@ -0,0 +1,48 @@
+---
+name: Rerequest a check run
+example: octokit.rest.checks.rerequestRun({ owner, repo, check_run_id })
+route: POST /repos/{owner}/{repo}/check-runs/{check_run_id}/rerequest
+scope: checks
+type: API method
+---
+
+# Rerequest a check run
+
+Triggers GitHub to rerequest an existing check run, without pushing new code to a repository. This endpoint will trigger the [`check_run` webhook](https://docs.github.com/webhooks/event-payloads/#check_run) event with the action `rerequested`. When a check run is `rerequested`, its `status` is reset to `queued` and the `conclusion` is cleared.
+
+To rerequest a check run, your GitHub App must have the `checks:read` permission on a private repository or pull access to a public repository.
+
+```js
+octokit.rest.checks.rerequestRun({
+  owner,
+  repo,
+  check_run_id,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>owner</td><td>yes</td><td>
+
+</td></tr>
+<tr><td>repo</td><td>yes</td><td>
+
+</td></tr>
+<tr><td>check_run_id</td><td>yes</td><td>
+
+check_run_id parameter
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/checks#rerequest-a-check-run).

docs/codeScanning/getAnalysis.md

@@ -27,9 +27,6 @@ the response contains the analysis data that was uploaded.
 This is formatted as
 [SARIF version 2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html).
 
-**Deprecation notice**:
-The `tool_name` field is deprecated and will, in future, not be included in the response for this endpoint. The example response reflects this change. The tool name can now be found inside the `tool` field.
-
 ```js
 octokit.rest.codeScanning.getAnalysis({
   owner,

docs/migrations/listReposForAuthenticatedUser.md

@@ -0,0 +1,48 @@
+---
+name: List repositories for a user migration
+example: octokit.rest.migrations.listReposForAuthenticatedUser({ migration_id })
+route: GET /user/migrations/{migration_id}/repositories
+scope: migrations
+type: API method
+---
+
+# List repositories for a user migration
+
+Lists all the repositories for this user migration.
+
+```js
+octokit.rest.migrations.listReposForAuthenticatedUser({
+  migration_id,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>migration_id</td><td>yes</td><td>
+
+migration_id parameter
+
+</td></tr>
+<tr><td>per_page</td><td>no</td><td>
+
+Results per page (max 100)
+
+</td></tr>
+<tr><td>page</td><td>no</td><td>
+
+Page number of the results to fetch.
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/migrations#list-repositories-for-a-user-migration).

docs/migrations/listReposForUser.md

@@ -8,6 +8,8 @@ type: API method
 
 # List repositories for a user migration
 
+**Deprecated:** This method has been renamed to migrations.listReposForAuthenticatedUser
+
 Lists all the repositories for this user migration.
 
 ```js

docs/repos/acceptInvitation.md

@@ -8,6 +8,8 @@ type: API method
 
 # Accept a repository invitation
 
+**Deprecated:** This method has been renamed to repos.acceptInvitationForAuthenticatedUser
+
 ```js
 octokit.rest.repos.acceptInvitation({
   invitation_id,