feat: many new endpoints, and updates (#713)

new DELETE method for `/notifications/threads/{thread_id}` endpoint, new organization-roles endpoints, new `/repos/{owner}/{repo}/pages/deployments/{pages_deployment_id}`, `/repos/{owner}/{repo}/pages/deployments/{pages_deployment_id}/cancel` endpoints, new PATCH method for `/repos/{owner}/{repo}/properties/values`, new `/repos/{owner}/{repo}/security-advisories/{ghsa_id}/forks` endpoint

Author: octokitbot

docs/actions/addCustomLabelsToSelfHostedRunnerForOrg.md

@@ -8,12 +8,11 @@ type: API method
 
 # Add custom labels to a self-hosted runner for an organization
 
-Add custom labels to a self-hosted runner configured in an organization.
+Adds custom labels to a self-hosted runner configured in an organization.
 
-You must authenticate using an access token with the `admin:org` scope to use this endpoint.
-If the repository is private, you must use an access token with the `repo` scope.
-GitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.
-Authenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.
+Authenticated users must have admin access to the organization to use this endpoint.
+
+OAuth tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.addCustomLabelsToSelfHostedRunnerForOrg({

docs/actions/addCustomLabelsToSelfHostedRunnerForRepo.md

@@ -8,11 +8,11 @@ type: API method
 
 # Add custom labels to a self-hosted runner for a repository
 
-Add custom labels to a self-hosted runner configured in a repository.
+Adds custom labels to a self-hosted runner configured in a repository.
 
-You must authenticate using an access token with the `repo` scope to use this endpoint.
-GitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.
-Authenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.
+Authenticated users must have admin access to the organization to use this endpoint.
+
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.addCustomLabelsToSelfHostedRunnerForRepo({

docs/actions/addSelectedRepoToOrgSecret.md

@@ -9,14 +9,13 @@ type: API method
 # Add selected repository to an organization secret
 
 Adds a repository to an organization secret when the `visibility` for
-repository access is set to `selected`. The visibility is set when you [Create or
+repository access is set to `selected`. For more information about setting the visibility, see [Create or
 update an organization secret](https://docs.github.com/rest/actions/secrets#create-or-update-an-organization-secret).
 
-You must authenticate using an access token with the `admin:org` scope to use this endpoint.
-If the repository is private, you must use an access token with the `repo` scope.
-GitHub Apps must have the `secrets` organization permission to use this endpoint.
 Authenticated users must have collaborator access to a repository to create, update, or read secrets.
 
+OAuth tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. If the repository is private, OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
+
 ```js
 octokit.rest.actions.addSelectedRepoToOrgSecret({
   org,

docs/actions/addSelectedRepoToOrgVariable.md

@@ -11,10 +11,9 @@ type: API method
 Adds a repository to an organization variable that is available to selected repositories.
 Organization variables that are available to selected repositories have their `visibility` field set to `selected`.
 
-You must authenticate using an access token with the `admin:org` scope to use this endpoint.
-If the repository is private, you must use an access token with the `repo` scope.
-GitHub Apps must have the `organization_actions_variables:write` organization permission to use this endpoint.
-Authenticated users must have collaborator access to a repository to create, update, or read variables.
+Authenticated users must have collaborator access to a repository to create, update, or read secrets.
+
+OAuth tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. If the repository is private, OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.addSelectedRepoToOrgVariable({

docs/actions/approveWorkflowRun.md

@@ -10,7 +10,7 @@ type: API method
 
 Approves a workflow run for a pull request from a public fork of a first time contributor. For more information, see ["Approving workflow runs from public forks](https://docs.github.com/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks)."
 
-You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint.
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.approveWorkflowRun({

docs/actions/cancelWorkflowRun.md

@@ -10,8 +10,7 @@ type: API method
 
 Cancels a workflow run using its `id`.
 
-You must authenticate using an access token with the `repo` scope to use this endpoint.
-GitHub Apps must have the `actions:write` permission to use this endpoint.
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.cancelWorkflowRun({

docs/actions/createEnvironmentVariable.md

@@ -10,10 +10,10 @@ type: API method
 
 Create an environment variable that you can reference in a GitHub Actions workflow.
 
-You must authenticate using an access token with the `repo` scope to use this endpoint.
-GitHub Apps must have the `environment:write` repository permission to use this endpoint.
 Authenticated users must have collaborator access to a repository to create, update, or read variables.
 
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
+
 ```js
 octokit.rest.actions.createEnvironmentVariable({
   repository_id,
@@ -41,7 +41,7 @@ The unique identifier of the repository.
 </td></tr>
 <tr><td>environment_name</td><td>yes</td><td>
 
-The name of the environment.
+The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with `%2F`.
 
 </td></tr>
 <tr><td>name</td><td>yes</td><td>

docs/actions/createOrUpdateEnvironmentSecret.md

@@ -11,10 +11,10 @@ type: API method
 Creates or updates an environment secret with an encrypted value. Encrypt your secret using
 [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). For more information, see "[Encrypting secrets for the REST API](https://docs.github.com/rest/guides/encrypting-secrets-for-the-rest-api)."
 
-You must authenticate using an access token with the `repo` scope to use this endpoint.
-GitHub Apps must have the `secrets` repository permission to use this endpoint.
 Authenticated users must have collaborator access to a repository to create, update, or read secrets.
 
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
+
 ```js
 octokit.rest.actions.createOrUpdateEnvironmentSecret({
   repository_id,
@@ -43,7 +43,7 @@ The unique identifier of the repository.
 </td></tr>
 <tr><td>environment_name</td><td>yes</td><td>
 
-The name of the environment.
+The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with `%2F`.
 
 </td></tr>
 <tr><td>secret_name</td><td>yes</td><td>

docs/actions/createOrUpdateRepoSecret.md

@@ -11,10 +11,10 @@ type: API method
 Creates or updates a repository secret with an encrypted value. Encrypt your secret using
 [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). For more information, see "[Encrypting secrets for the REST API](https://docs.github.com/rest/guides/encrypting-secrets-for-the-rest-api)."
 
-You must authenticate using an access token with the `repo` scope to use this endpoint.
-GitHub Apps must have the `secrets` repository permission to use this endpoint.
 Authenticated users must have collaborator access to a repository to create, update, or read secrets.
 
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
+
 ```js
 octokit.rest.actions.createOrUpdateRepoSecret({
   owner,

docs/actions/createOrgVariable.md

@@ -10,11 +10,10 @@ type: API method
 
 Creates an organization variable that you can reference in a GitHub Actions workflow.
 
-You must authenticate using an access token with the `admin:org` scope to use this endpoint.
-If the repository is private, you must use an access token with the `repo` scope.
-GitHub Apps must have the `organization_actions_variables:write` organization permission to use this endpoint.
 Authenticated users must have collaborator access to a repository to create, update, or read variables.
 
+OAuth tokens and personal access tokens (classic) need the`admin:org` scope to use this endpoint. If the repository is private, OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
+
 ```js
 octokit.rest.actions.createOrgVariable({
   org,