octokit · gr2m · May 5, 2020 · May 5, 2020 · May 5, 2020
diff --git a/docs/actions/cancelWorkflowRun.md b/docs/actions/cancelWorkflowRun.md
@@ -8,7 +8,7 @@ type: API method
 
 # Cancel a workflow run
 
-Cancels a workflow run using its `id`. Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Cancels a workflow run using its `id`. Anyone with write access to the repository and an access token with the `repo` scope can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
 
 ```js
 octokit.actions.cancelWorkflowRun({

diff --git a/docs/actions/createOrUpdateSecretForRepo.md b/docs/actions/createOrUpdateSecretForRepo.md
@@ -8,7 +8,7 @@ type: API method
 
 # Create or update a secret for a repository
 
-Creates or updates a secret with an encrypted value. Encrypt your secret using [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.
+Creates or updates a secret with an encrypted value. Encrypt your secret using [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). Anyone with write access to the repository and an access token with the `repo` scope can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.
 
 Encrypt your secret using the [tweetsodium](https://github.com/mastahyeti/tweetsodium) library.
 

diff --git a/docs/actions/createRegistrationToken.md b/docs/actions/createRegistrationToken.md
@@ -10,7 +10,7 @@ type: API method
 
 **Deprecated:** This method has been renamed to actions.createRegistrationTokenForRepo
 
-Returns a token that you can pass to the `config` script. The token expires after one hour. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:write` repository permission to use this endpoint.
+Returns a token that you can pass to the `config` script. The token expires after one hour. Anyone with admin access to the repository and an access token with the `repo` scope can use this endpoint.
 
 Configure your self-hosted runner, replacing TOKEN with the registration token provided by this endpoint.
 

diff --git a/docs/actions/createRegistrationTokenForOrg.md b/docs/actions/createRegistrationTokenForOrg.md
@@ -10,7 +10,7 @@ type: API method
 
 **Warning:** The self-hosted runners API for organizations is currently in public beta and subject to change.
 
-Returns a token that you can pass to the `config` script. The token expires after one hour. Anyone with admin access to the organization can use this endpoint. GitHub Apps must have the `self-hosted runners:write` organization permission to use this endpoint.
+Returns a token that you can pass to the `config` script. The token expires after one hour. Anyone with admin access to the organization can use this endpoint.
 
 Configure your self-hosted runner, replacing `TOKEN` with the registration token provided by this endpoint.
 

diff --git a/docs/actions/createRegistrationTokenForRepo.md b/docs/actions/createRegistrationTokenForRepo.md
@@ -8,7 +8,7 @@ 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. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:write` repository permission to use this endpoint.
+Returns a token that you can pass to the `config` script. The token expires after one hour. Anyone with admin access to the repository and an access token with the `repo` scope can use this endpoint.
 
 Configure your self-hosted runner, replacing TOKEN with the registration token provided by this endpoint.
 

diff --git a/docs/actions/createRemoveToken.md b/docs/actions/createRemoveToken.md
@@ -10,7 +10,7 @@ type: API method
 
 **Deprecated:** This method has been renamed to actions.createRemoveTokenForRepo
 
-Returns a token that you can pass to remove a self-hosted runner from a repository. The token expires after one hour. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:write` repository permission to use this endpoint.
+Returns a token that you can pass to remove a self-hosted runner from a repository. The token expires after one hour. Anyone with admin access to the repository and an access token with the `repo` scope can use this endpoint.
 
 Remove your self-hosted runner from a repository, replacing TOKEN with the remove token provided by this endpoint.
 

diff --git a/docs/actions/createRemoveTokenForOrg.md b/docs/actions/createRemoveTokenForOrg.md
@@ -10,7 +10,7 @@ type: API method
 
 **Warning:** The self-hosted runners API for organizations is currently in public beta and subject to change.
 
-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. Anyone with admin access to the organization can use this endpoint. GitHub Apps must have the `self-hosted runners:write` organization permission to use this endpoint.
+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. Anyone with admin access to the organization can use this endpoint.
 
 To remove your self-hosted runner from an organization, replace `TOKEN` with the remove token provided by this endpoint.
 

diff --git a/docs/actions/createRemoveTokenForRepo.md b/docs/actions/createRemoveTokenForRepo.md
@@ -8,7 +8,7 @@ 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. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:write` repository permission to use this endpoint.
+Returns a token that you can pass to remove a self-hosted runner from a repository. The token expires after one hour. Anyone with admin access to the repository and an access token with the `repo` scope can use this endpoint.
 
 Remove your self-hosted runner from a repository, replacing TOKEN with the remove token provided by this endpoint.
 

diff --git a/docs/actions/deleteArtifact.md b/docs/actions/deleteArtifact.md
@@ -8,7 +8,7 @@ type: API method
 
 # Delete an artifact
 
-Deletes an artifact for a workflow run. Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Deletes an artifact for a workflow run. Anyone with write access to the repository and an access token with the `repo` scope can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
 
 ```js
 octokit.actions.deleteArtifact({

diff --git a/docs/actions/deleteSecretFromRepo.md b/docs/actions/deleteSecretFromRepo.md
@@ -8,7 +8,7 @@ type: API method
 
 # Delete a secret from a repository
 
-Deletes a secret in a repository using the secret name. Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.
+Deletes a secret in a repository using the secret name. Anyone with write access to the repository and an access token with the `repo` scope can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.
 
 ```js
 octokit.actions.deleteSecretFromRepo({

diff --git a/docs/actions/deleteSelfHostedRunnerFromOrg.md b/docs/actions/deleteSelfHostedRunnerFromOrg.md
@@ -10,7 +10,7 @@ type: API method
 
 **Warning:** The self-hosted runners API for organizations is currently in public beta and subject to change.
 
-Forces the removal of a self-hosted runner from an organization. You can use this endpoint to completely remove the runner when the machine you were using no longer exists. Anyone with admin access to the organization can use this endpoint. GitHub Apps must have the `self-hosted runners:write` organization permission to use this endpoint.
+Forces the removal of a self-hosted runner from an organization. You can use this endpoint to completely remove the runner when the machine you were using no longer exists. Anyone with admin access to the organization can use this endpoint.
 
 ```js
 octokit.actions.deleteSelfHostedRunnerFromOrg({

diff --git a/docs/actions/deleteSelfHostedRunnerFromRepo.md b/docs/actions/deleteSelfHostedRunnerFromRepo.md
@@ -8,7 +8,7 @@ type: API method
 
 # Delete a self-hosted runner from a repository
 
-Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:write` repository permission to use this endpoint.
+Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists. Anyone with admin access to the repository and an access token with the `repo` scope can use this endpoint.
 
 ```js
 octokit.actions.deleteSelfHostedRunnerFromRepo({

diff --git a/docs/actions/deleteWorkflowRunLogs.md b/docs/actions/deleteWorkflowRunLogs.md
@@ -8,7 +8,7 @@ type: API method
 
 # Delete workflow run logs
 
-Deletes all logs for a workflow run. Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Deletes all logs for a workflow run. Anyone with write access to the repository and an access token with the `repo` scope can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
 
 ```js
 octokit.actions.deleteWorkflowRunLogs({

diff --git a/docs/actions/downloadArtifact.md b/docs/actions/downloadArtifact.md
@@ -8,7 +8,7 @@ type: API method
 
 # Download an artifact
 
-Gets a redirect URL to download an archive for a repository. This URL expires after 1 minute. Look for `Location:` in the response header to find the URL for the download. The `:archive_format` must be `zip`. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Gets a redirect URL to download an archive for a repository. This URL expires after 1 minute. Look for `Location:` in the response header to find the URL for the download. The `:archive_format` must be `zip`. 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` permission to use this endpoint.
 
 Call this endpoint using the `-v` flag, which enables verbose output and allows you to see the download URL in the header. To download the file into the current working directory, specify the filename using the `-o` flag.
 

diff --git a/docs/actions/downloadWorkflowJobLogs.md b/docs/actions/downloadWorkflowJobLogs.md
@@ -0,0 +1,52 @@
+---
+name: Download workflow job logs
+example: octokit.actions.downloadWorkflowJobLogs({ owner, repo, job_id })
+route: GET /repos/{owner}/{repo}/actions/jobs/{job_id}/logs
+scope: actions
+type: API method
+---
+
+# Download workflow job logs
+
+Gets a redirect URL to download a plain text file of logs for a workflow job. 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` permission to use this endpoint.
+
+Call this endpoint using the `-v` flag, which enables verbose output and allows you to see the download URL in the header. To download the file into the current working directory, specify the filename using the `-o` flag.
+
+```js
+octokit.actions.downloadWorkflowJobLogs({
+  owner,
+  repo,
+  job_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>
+
+owner parameter
+
+</td></tr>
+<tr><td>repo</td><td>yes</td><td>
+
+repo parameter
+
+</td></tr>
+<tr><td>job_id</td><td>yes</td><td>
+
+job_id parameter
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/workflow-jobs/#download-workflow-job-logs).
diff --git a/docs/actions/downloadWorkflowRunLogs.md b/docs/actions/downloadWorkflowRunLogs.md
@@ -0,0 +1,52 @@
+---
+name: Download workflow run logs
+example: octokit.actions.downloadWorkflowRunLogs({ owner, repo, run_id })
+route: GET /repos/{owner}/{repo}/actions/runs/{run_id}/logs
+scope: actions
+type: API method
+---
+
+# Download workflow run logs
+
+Gets a redirect URL to download an archive of log files for a workflow run. 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` permission to use this endpoint.
+
+Call this endpoint using the `-v` flag, which enables verbose output and allows you to see the download URL in the header. To download the file into the current working directory, specify the filename using the `-o` flag.
+
+```js
+octokit.actions.downloadWorkflowRunLogs({
+  owner,
+  repo,
+  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>
+
+owner parameter
+
+</td></tr>
+<tr><td>repo</td><td>yes</td><td>
+
+repo parameter
+
+</td></tr>
+<tr><td>run_id</td><td>yes</td><td>
+
+run_id parameter
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/workflow-runs/#download-workflow-run-logs).
diff --git a/docs/actions/getArtifact.md b/docs/actions/getArtifact.md
@@ -8,7 +8,7 @@ type: API method
 
 # Get an artifact
 
-Gets a specific artifact for a workflow run. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Gets a specific artifact for a workflow run. 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` permission to use this endpoint.
 
 ```js
 octokit.actions.getArtifact({

diff --git a/docs/actions/getPublicKey.md b/docs/actions/getPublicKey.md
@@ -8,7 +8,7 @@ type: API method
 
 # Get your public key
 
-Gets your public key, which you must store. You need your public key to use other secrets endpoints. Use the returned `key` to encrypt your secrets. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.
+Gets your public key, which you must store. You need your public key to use other secrets endpoints. Use the returned `key` to encrypt your secrets. 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 `secrets` permission to use this endpoint.
 
 ```js
 octokit.actions.getPublicKey({

diff --git a/docs/actions/getSecret.md b/docs/actions/getSecret.md
@@ -8,7 +8,7 @@ type: API method
 
 # Get a secret
 
-Gets a single secret without revealing its encrypted value. Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.
+Gets a single secret without revealing its encrypted value. Anyone with write access to the repository and an access token with the `repo` scope can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.
 
 ```js
 octokit.actions.getSecret({

diff --git a/docs/actions/getSelfHostedRunner.md b/docs/actions/getSelfHostedRunner.md
@@ -10,7 +10,7 @@ type: API method
 
 **Deprecated:** This method has been renamed to actions.getSelfHostedRunnerForRepo
 
-Gets a specific self-hosted runner. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:read` repository permission to use this endpoint.
+Gets a specific self-hosted runner. Anyone with admin access to the repository and an access token with the `repo` scope can use this endpoint.
 
 ```js
 octokit.actions.getSelfHostedRunner({

diff --git a/docs/actions/getSelfHostedRunnerForOrg.md b/docs/actions/getSelfHostedRunnerForOrg.md
@@ -10,7 +10,7 @@ type: API method
 
 **Warning:** The self-hosted runners API for organizations is currently in public beta and subject to change.
 
-Gets a specific self-hosted runner for an organization. Anyone with admin access to the organization can use this endpoint. GitHub Apps must have the `self-hosted runners:read` organization permission to use this endpoint.
+Gets a specific self-hosted runner for an organization. Anyone with admin access to the organization can use this endpoint.
 
 ```js
 octokit.actions.getSelfHostedRunnerForOrg({

diff --git a/docs/actions/getSelfHostedRunnerForRepo.md b/docs/actions/getSelfHostedRunnerForRepo.md
@@ -8,7 +8,7 @@ type: API method
 
 # Get a self-hosted runner for a repository
 
-Gets a specific self-hosted runner. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:read` repository permission to use this endpoint.
+Gets a specific self-hosted runner. Anyone with admin access to the repository and an access token with the `repo` scope can use this endpoint.
 
 ```js
 octokit.actions.getSelfHostedRunnerForRepo({

diff --git a/docs/actions/getWorkflow.md b/docs/actions/getWorkflow.md
@@ -8,7 +8,7 @@ type: API method
 
 # Get a workflow
 
-Gets a specific workflow. You can also replace `:workflow_id` with `:workflow_file_name`. For example, you could use `main.yml`. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Gets a specific workflow. You can also replace `:workflow_id` with `:workflow_file_name`. For example, you could use `main.yml`. 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` permission to use this endpoint.
 
 ```js
 octokit.actions.getWorkflow({

diff --git a/docs/actions/getWorkflowJob.md b/docs/actions/getWorkflowJob.md
@@ -8,7 +8,7 @@ type: API method
 
 # Get a workflow job
 
-Gets a specific job in a workflow run. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Gets a specific job in a workflow run. 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` permission to use this endpoint.
 
 ```js
 octokit.actions.getWorkflowJob({

diff --git a/docs/actions/getWorkflowRun.md b/docs/actions/getWorkflowRun.md
@@ -8,7 +8,7 @@ type: API method
 
 # Get a workflow run
 
-Gets a specific workflow run. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Gets a specific workflow run. 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` permission to use this endpoint.
 
 ```js
 octokit.actions.getWorkflowRun({

diff --git a/docs/actions/listArtifactsForRepo.md b/docs/actions/listArtifactsForRepo.md
@@ -8,7 +8,7 @@ type: API method
 
 # List artifacts for a repository
 
-Lists all artifacts for a repository. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Lists all artifacts for a repository. 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` permission to use this endpoint.
 
 ```js
 octokit.actions.listArtifactsForRepo({

diff --git a/docs/actions/listDownloadsForSelfHostedRunnerApplication.md b/docs/actions/listDownloadsForSelfHostedRunnerApplication.md
@@ -10,7 +10,7 @@ type: API method
 
 **Deprecated:** This method has been renamed to actions.listRunnerApplicationsForRepo
 
-Lists binaries for the runner application that you can download and run. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:read` repository permission to use this endpoint.
+Lists binaries for the runner application that you can download and run. Anyone with admin access to the repository and an access token with the `repo` scope can use this endpoint.
 
 ```js
 octokit.actions.listDownloadsForSelfHostedRunnerApplication({

diff --git a/docs/actions/listJobsForWorkflowRun.md b/docs/actions/listJobsForWorkflowRun.md
@@ -8,7 +8,7 @@ type: API method
 
 # List jobs for a workflow run
 
-Lists jobs for a workflow run. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://developer.github.com/v3/#parameters).
+Lists jobs for a workflow run. 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` permission to use this endpoint. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://developer.github.com/v3/#parameters).
 
 ```js
 octokit.actions.listJobsForWorkflowRun({