docs: updated to latest OpenAPI spec

Author: gr2m

docs/actions/addSelectedRepoToOrgSecret.md

@@ -8,13 +8,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 update an organization secret](https://developer.github.com/v3/actions/secrets/#create-or-update-an-organization-secret). You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `secrets` organization permission to use this endpoint.
+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 update an organization secret](https://docs.github.com/rest/reference/actions#create-or-update-an-organization-secret). You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `secrets` organization permission to use this endpoint.
 
 ```js
 octokit.actions.addSelectedRepoToOrgSecret({
   org,
   secret_name,
-  repository_id,
+  repository_id
 });
 ```
 
@@ -34,11 +34,13 @@ octokit.actions.addSelectedRepoToOrgSecret({
 </td></tr>
 <tr><td>secret_name</td><td>yes</td><td>
 
+secret_name parameter
+
 </td></tr>
 <tr><td>repository_id</td><td>yes</td><td>
 
 </td></tr>
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/secrets/#add-selected-repository-to-an-organization-secret).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#add-selected-repository-to-an-organization-secret).

docs/actions/cancelWorkflowRun.md

@@ -14,7 +14,7 @@ Cancels a workflow run using its `id`. You must authenticate using an access tok
 octokit.actions.cancelWorkflowRun({
   owner,
   repo,
-  run_id,
+  run_id
 });
 ```
 
@@ -41,4 +41,4 @@ octokit.actions.cancelWorkflowRun({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/workflow-runs/#cancel-a-workflow-run).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#cancel-a-workflow-run).

docs/actions/createOrUpdateOrgSecret.md

@@ -52,7 +52,7 @@ def encrypt(public_key: str, secret_value: str) -> str:
   return b64encode(encrypted).decode("utf-8")
 ```
 
-#### Example encrypting a secret using C#
+#### Example encrypting a secret using C
 
 Encrypt your secret using the [Sodium.Core](https://www.nuget.org/packages/Sodium.Core/) package.
 
@@ -86,7 +86,7 @@ puts Base64.strict_encode64(encrypted_secret)
 ```js
 octokit.actions.createOrUpdateOrgSecret({
   org,
-  secret_name,
+  secret_name
 });
 ```
 
@@ -106,10 +106,12 @@ octokit.actions.createOrUpdateOrgSecret({
 </td></tr>
 <tr><td>secret_name</td><td>yes</td><td>
 
+secret_name parameter
+
 </td></tr>
 <tr><td>encrypted_value</td><td>no</td><td>
 
-Value for your secret, encrypted with [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages) using the public key retrieved from the [Get an organization public key](https://developer.github.com/v3/actions/secrets/#get-an-organization-public-key) endpoint.
+Value for your secret, encrypted with [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages) using the public key retrieved from the [Get an organization public key](https://docs.github.com/rest/reference/actions#get-an-organization-public-key) endpoint.
 
 </td></tr>
 <tr><td>key_id</td><td>no</td><td>
@@ -119,18 +121,18 @@ ID of the key you used to encrypt the secret.
 </td></tr>
 <tr><td>visibility</td><td>no</td><td>
 
-Configures the access that repositories have to the organization secret. Can be one of:
-\- `all` - All repositories in an organization can access the secret.
-\- `private` - Private repositories in an organization can access the secret.
+Configures the access that repositories have to the organization secret. Can be one of:  
+\- `all` - All repositories in an organization can access the secret.  
+\- `private` - Private repositories in an organization can access the secret.  
 \- `selected` - Only specific repositories can access the secret.
 
 </td></tr>
 <tr><td>selected_repository_ids</td><td>no</td><td>
 
-An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the `visibility` is set to `selected`. You can manage the list of selected repositories using the [List selected repositories for an organization secret](https://developer.github.com/v3/actions/secrets/#list-selected-repositories-for-an-organization-secret), [Set selected repositories for an organization secret](https://developer.github.com/v3/actions/secrets/#set-selected-repositories-for-an-organization-secret), and [Remove selected repository from an organization secret](https://developer.github.com/v3/actions/secrets/#remove-selected-repository-from-an-organization-secret) endpoints.
+An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the `visibility` is set to `selected`. You can manage the list of selected repositories using the [List selected repositories for an organization secret](https://docs.github.com/rest/reference/actions#list-selected-repositories-for-an-organization-secret), [Set selected repositories for an organization secret](https://docs.github.com/rest/reference/actions#set-selected-repositories-for-an-organization-secret), and [Remove selected repository from an organization secret](https://docs.github.com/rest/reference/actions#remove-selected-repository-from-an-organization-secret) endpoints.
 
 </td></tr>
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/secrets/#create-or-update-an-organization-secret).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#create-or-update-an-organization-secret).

docs/actions/createOrUpdateRepoSecret.md

@@ -52,7 +52,7 @@ def encrypt(public_key: str, secret_value: str) -> str:
   return b64encode(encrypted).decode("utf-8")
 ```
 
-#### Example encrypting a secret using C#
+#### Example encrypting a secret using C
 
 Encrypt your secret using the [Sodium.Core](https://www.nuget.org/packages/Sodium.Core/) package.
 
@@ -87,7 +87,7 @@ puts Base64.strict_encode64(encrypted_secret)
 octokit.actions.createOrUpdateRepoSecret({
   owner,
   repo,
-  secret_name,
+  secret_name
 });
 ```
 
@@ -110,10 +110,12 @@ octokit.actions.createOrUpdateRepoSecret({
 </td></tr>
 <tr><td>secret_name</td><td>yes</td><td>
 
+secret_name parameter
+
 </td></tr>
 <tr><td>encrypted_value</td><td>no</td><td>
 
-Value for your secret, encrypted with [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages) using the public key retrieved from the [Get a repository public key](https://developer.github.com/v3/actions/secrets/#get-a-repository-public-key) endpoint.
+Value for your secret, encrypted with [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages) using the public key retrieved from the [Get a repository public key](https://docs.github.com/rest/reference/actions#get-a-repository-public-key) endpoint.
 
 </td></tr>
 <tr><td>key_id</td><td>no</td><td>
@@ -124,4 +126,4 @@ ID of the key you used to encrypt the secret.
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/secrets/#create-or-update-a-repository-secret).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#create-or-update-a-repository-secret).

docs/actions/createRegistrationTokenForOrg.md

@@ -22,7 +22,7 @@ Configure your self-hosted runner, replacing `TOKEN` with the registration token
 
 ```js
 octokit.actions.createRegistrationTokenForOrg({
-  org,
+  org
 });
 ```
 
@@ -43,4 +43,4 @@ octokit.actions.createRegistrationTokenForOrg({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/self-hosted-runners/#create-a-registration-token-for-an-organization).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#create-a-registration-token-for-an-organization).

docs/actions/createRegistrationTokenForRepo.md

@@ -22,7 +22,7 @@ Configure your self-hosted runner, replacing `TOKEN` with the registration token
 ```js
 octokit.actions.createRegistrationTokenForRepo({
   owner,
-  repo,
+  repo
 });
 ```
 
@@ -46,4 +46,4 @@ octokit.actions.createRegistrationTokenForRepo({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/self-hosted-runners/#create-a-registration-token-for-a-repository).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#create-a-registration-token-for-a-repository).

docs/actions/createRemoveTokenForOrg.md

@@ -23,7 +23,7 @@ endpoint.
 
 ```js
 octokit.actions.createRemoveTokenForOrg({
-  org,
+  org
 });
 ```
 
@@ -44,4 +44,4 @@ octokit.actions.createRemoveTokenForOrg({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/self-hosted-runners/#create-a-remove-token-for-an-organization).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#create-a-remove-token-for-an-organization).

docs/actions/createRemoveTokenForRepo.md

@@ -22,7 +22,7 @@ To remove your self-hosted runner from a repository, replace TOKEN with the remo
 ```js
 octokit.actions.createRemoveTokenForRepo({
   owner,
-  repo,
+  repo
 });
 ```
 
@@ -46,4 +46,4 @@ octokit.actions.createRemoveTokenForRepo({
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/self-hosted-runners/#create-a-remove-token-for-a-repository).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#create-a-remove-token-for-a-repository).

docs/actions/createWorkflowDispatch.md

@@ -8,18 +8,18 @@ type: API method
 
 # Create a workflow dispatch event
 
-You can use this endpoint to manually trigger a GitHub Actions workflow run. You can also replace `{workflow_id}` with the workflow file name. For example, you could use `main.yml`.
+You can use this endpoint to manually trigger a GitHub Actions workflow run. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`.
 
 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)."
+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://help.github.com/articles/creating-a-personal-access-token-for-the-command-line)."
 
 ```js
 octokit.actions.createWorkflowDispatch({
   owner,
   repo,
   workflow_id,
-  ref,
+  ref
 });
 ```
 
@@ -42,15 +42,17 @@ octokit.actions.createWorkflowDispatch({
 </td></tr>
 <tr><td>workflow_id</td><td>yes</td><td>
 
+The ID of the workflow. You can also pass the workflow file name as a string.
+
 </td></tr>
 <tr><td>ref</td><td>yes</td><td>
 
-The reference of the workflow run. The reference can be a branch, tag, or a commit SHA.
+The git reference for the workflow. The reference can be a branch or tag name.
 
 </td></tr>
 <tr><td>inputs</td><td>no</td><td>
 
-Input keys and values configured in the workflow file. The maximum number of properties is 10.
+Input keys and values configured in the workflow file. The maximum number of properties is 10. Any default properties configured in the workflow file will be used when `inputs` are omitted.
 
 </td></tr>
 <tr><td>inputs.*</td><td>no</td><td>
@@ -59,4 +61,4 @@ Input keys and values configured in the workflow file. The maximum number of pro
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/workflows/#create-a-workflow-dispatch-event).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#create-a-workflow-dispatch-event).

docs/actions/deleteArtifact.md

@@ -14,7 +14,7 @@ Deletes an artifact for a workflow run. You must authenticate using an access to
 octokit.actions.deleteArtifact({
   owner,
   repo,
-  artifact_id,
+  artifact_id
 });
 ```
 
@@ -37,8 +37,10 @@ octokit.actions.deleteArtifact({
 </td></tr>
 <tr><td>artifact_id</td><td>yes</td><td>
 
+artifact_id parameter
+
 </td></tr>
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/actions/artifacts/#delete-an-artifact).
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/reference/actions#delete-an-artifact).