octokit · wolfy1339 · Feb 22, 2024 · Feb 15, 2024 · Feb 22, 2024 · Feb 22, 2024
diff --git a/docs/actions/addCustomLabelsToSelfHostedRunnerForOrg.md b/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({

diff --git a/docs/actions/addCustomLabelsToSelfHostedRunnerForRepo.md b/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({

diff --git a/docs/actions/addSelectedRepoToOrgSecret.md b/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,

diff --git a/docs/actions/addSelectedRepoToOrgVariable.md b/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({

diff --git a/docs/actions/approveWorkflowRun.md b/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({

diff --git a/docs/actions/cancelWorkflowRun.md b/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({

diff --git a/docs/actions/createEnvironmentVariable.md b/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>

diff --git a/docs/actions/createOrUpdateEnvironmentSecret.md b/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>

diff --git a/docs/actions/createOrUpdateRepoSecret.md b/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,

diff --git a/docs/actions/createOrgVariable.md b/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,

diff --git a/docs/actions/createRegistrationTokenForOrg.md b/docs/actions/createRegistrationTokenForOrg.md
@@ -10,19 +10,16 @@ type: API method
 
 Returns a token that you can pass to the `config` script. The token expires after one hour.
 
-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.
-
-Example using registration token:
-
-Configure your self-hosted runner, replacing `TOKEN` with the registration token provided by this endpoint.
+For example, you can replace `TOKEN` in the following example with the registration token provided by this endpoint to configure your self-hosted runner:
 
 ```
 ./config.sh --url https://github.com/octo-org --token TOKEN
 ```
 
+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. If the repository is private, OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
+
 ```js
 octokit.rest.actions.createRegistrationTokenForOrg({
   org,

diff --git a/docs/actions/createRegistrationTokenForRepo.md b/docs/actions/createRegistrationTokenForRepo.md
@@ -8,19 +8,17 @@ type: API method
 
 # Create a registration token for a repository
 
-Returns a token that you can pass to the `config` script. The token
-expires after one hour.
+Returns a token that you can pass to the `config` script. The token expires after one hour.
 
-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.
+For example, you can replace `TOKEN` in the following example with the registration token provided by this endpoint to configure your self-hosted runner:
 
-Example using registration token:
+```
+./config.sh --url https://github.com/octo-org --token TOKEN
+```
 
-Configure your self-hosted runner, replacing `TOKEN` with the registration token provided
-by this endpoint.
+Authenticated users must have admin access to the repository to use this endpoint.
 
-`config.sh --url https://github.com/octo-org/octo-repo-artifacts --token TOKEN`
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.createRegistrationTokenForRepo({

diff --git a/docs/actions/createRemoveTokenForOrg.md b/docs/actions/createRemoveTokenForOrg.md
@@ -10,20 +10,16 @@ type: API method
 
 Returns a token that you can pass to the `config` script to remove a self-hosted runner from an organization. The token expires after one hour.
 
-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.
-
-Example using remove token:
-
-To remove your self-hosted runner from an organization, replace `TOKEN` with the remove token provided by this
-endpoint.
+For example, you can replace `TOKEN` in the following example with the registration token provided by this endpoint to remove your self-hosted runner from an organization:
 
 ```
 ./config.sh remove --token TOKEN
 ```
 
+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. If the repository is private, OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
+
 ```js
 octokit.rest.actions.createRemoveTokenForOrg({
   org,

diff --git a/docs/actions/createRemoveTokenForRepo.md b/docs/actions/createRemoveTokenForRepo.md
@@ -8,19 +8,17 @@ type: API method
 
 # Create a remove token for a repository
 
-Returns a token that you can pass to remove a self-hosted runner from
-a repository. The token expires after one hour.
+Returns a token that you can pass to the `config` script to remove a self-hosted runner from an repository. The token expires after one hour.
 
-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.
+For example, you can replace `TOKEN` in the following example with the registration token provided by this endpoint to remove your self-hosted runner from an organization:
 
-Example using remove token:
+```
+./config.sh remove --token TOKEN
+```
 
-To remove your self-hosted runner from a repository, replace TOKEN with
-the remove token provided by this endpoint.
+Authenticated users must have admin access to the repository to use this endpoint.
 
-`config.sh remove --token TOKEN`
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.createRemoveTokenForRepo({

diff --git a/docs/actions/createRepoVariable.md b/docs/actions/createRepoVariable.md
@@ -10,10 +10,10 @@ type: API method
 
 Creates a repository 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 `actions_variables: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.createRepoVariable({
   owner,

diff --git a/docs/actions/createWorkflowDispatch.md b/docs/actions/createWorkflowDispatch.md
@@ -12,7 +12,7 @@ You can use this endpoint to manually trigger a GitHub Actions workflow run. You
 
 You must configure your GitHub Actions workflow to run when the [`workflow_dispatch` webhook](/developers/webhooks-and-events/webhook-events-and-payloads#workflow_dispatch) event occurs. The `inputs` are configured in the workflow file. For more information about how to configure the `workflow_dispatch` event in the workflow file, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#workflow_dispatch)."
 
-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. For more information, see "[Creating a personal access token for the command line](https://docs.github.com/articles/creating-a-personal-access-token-for-the-command-line)."
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.createWorkflowDispatch({

diff --git a/docs/actions/deleteActionsCacheById.md b/docs/actions/deleteActionsCacheById.md
@@ -10,9 +10,7 @@ type: API method
 
 Deletes a GitHub Actions cache for a repository, using a cache 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.deleteActionsCacheById({

diff --git a/docs/actions/deleteActionsCacheByKey.md b/docs/actions/deleteActionsCacheByKey.md
@@ -10,9 +10,7 @@ type: API method
 
 Deletes one or more GitHub Actions caches for a repository, using a complete cache key. By default, all caches that match the provided key are deleted, but you can optionally provide a Git ref to restrict deletions to caches that match both the provided key and the Git ref.
 
-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.deleteActionsCacheByKey({

diff --git a/docs/actions/deleteArtifact.md b/docs/actions/deleteArtifact.md
@@ -8,7 +8,8 @@ type: API method
 
 # Delete an artifact
 
-Deletes an artifact for a workflow run. 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.
+Deletes an artifact for a workflow run.
+OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.
 
 ```js
 octokit.rest.actions.deleteArtifact({

diff --git a/docs/actions/deleteEnvironmentSecret.md b/docs/actions/deleteEnvironmentSecret.md
@@ -10,10 +10,10 @@ type: API method
 
 Deletes a secret in an environment using the secret name.
 
-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.deleteEnvironmentSecret({
   repository_id,
@@ -40,7 +40,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>

diff --git a/docs/actions/deleteEnvironmentVariable.md b/docs/actions/deleteEnvironmentVariable.md
@@ -10,10 +10,10 @@ type: API method
 
 Deletes an environment variable using the variable name.
 
-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.deleteEnvironmentVariable({
   repository_id,
@@ -45,7 +45,7 @@ The name of the variable.
 </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>
   </tbody>

diff --git a/docs/actions/deleteOrgSecret.md b/docs/actions/deleteOrgSecret.md
@@ -10,11 +10,10 @@ type: API method
 
 Deletes a secret in an organization using the secret name.
 
-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.deleteOrgSecret({
   org,