feat: new /orgs/{org}/actions/runners/generate-jitconfig endpoint, …

…and documentation updates (#645)

docs/actions/addCustomLabelsToSelfHostedRunnerForRepo.md

@@ -40,7 +40,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>runner_id</td><td>yes</td><td>

docs/actions/approveWorkflowRun.md

@@ -38,7 +38,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>run_id</td><td>yes</td><td>

docs/actions/cancelWorkflowRun.md

@@ -36,7 +36,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>run_id</td><td>yes</td><td>

docs/actions/createOrUpdateEnvironmentSecret.md

@@ -13,7 +13,7 @@ Creates or updates an environment secret with an encrypted value. Encrypt your s
 token with the `repo` scope to use this endpoint. GitHub Apps must have the `secrets` repository permission to use
 this endpoint.
 
-#### Example encrypting a secret using Node.js
+**Example encrypting a secret using Node.js**
 
 Encrypt your secret using the [libsodium-wrappers](https://www.npmjs.com/package/libsodium-wrappers) library.
 
@@ -38,7 +38,7 @@ sodium.ready.then(() => {
 });
 ```
 
-#### Example encrypting a secret using Python
+**Example encrypting a secret using Python**
 
 Encrypt your secret using [pynacl](https://pynacl.readthedocs.io/en/latest/public/#nacl-public-sealedbox) with Python 3.
 
@@ -54,7 +54,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.
 
@@ -67,7 +67,7 @@ var sealedPublicKeyBox = Sodium.SealedPublicKeyBox.Create(secretValue, publicKey
 Console.WriteLine(Convert.ToBase64String(sealedPublicKeyBox));
 ```
 
-#### Example encrypting a secret using Ruby
+**Example encrypting a secret using Ruby**
 
 Encrypt your secret using the [rbnacl](https://github.com/RubyCrypto/rbnacl) gem.
 

docs/actions/createOrUpdateRepoSecret.md

@@ -13,7 +13,7 @@ Creates or updates a repository secret with an encrypted value. Encrypt your sec
 token with the `repo` scope to use this endpoint. GitHub Apps must have the `secrets` repository permission to use
 this endpoint.
 
-#### Example encrypting a secret using Node.js
+**Example encrypting a secret using Node.js**
 
 Encrypt your secret using the [libsodium-wrappers](https://www.npmjs.com/package/libsodium-wrappers) library.
 
@@ -38,7 +38,7 @@ sodium.ready.then(() => {
 });
 ```
 
-#### Example encrypting a secret using Python
+**Example encrypting a secret using Python**
 
 Encrypt your secret using [pynacl](https://pynacl.readthedocs.io/en/latest/public/#nacl-public-sealedbox) with Python 3.
 
@@ -54,7 +54,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.
 
@@ -67,7 +67,7 @@ var sealedPublicKeyBox = Sodium.SealedPublicKeyBox.Create(secretValue, publicKey
 Console.WriteLine(Convert.ToBase64String(sealedPublicKeyBox));
 ```
 
-#### Example encrypting a secret using Ruby
+**Example encrypting a secret using Ruby**
 
 Encrypt your secret using the [rbnacl](https://github.com/RubyCrypto/rbnacl) gem.
 
@@ -111,7 +111,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>secret_name</td><td>yes</td><td>

docs/actions/createRegistrationTokenForRepo.md

@@ -44,7 +44,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
   </tbody>

docs/actions/createRemoveTokenForRepo.md

@@ -44,7 +44,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
   </tbody>

docs/actions/createRepoVariable.md

@@ -39,7 +39,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>name</td><td>yes</td><td>

docs/actions/createWorkflowDispatch.md

@@ -41,7 +41,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>workflow_id</td><td>yes</td><td>

docs/actions/deleteActionsCacheById.md

@@ -40,7 +40,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>cache_id</td><td>yes</td><td>

docs/actions/deleteActionsCacheByKey.md

@@ -40,7 +40,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>key</td><td>yes</td><td>

docs/actions/deleteArtifact.md

@@ -36,7 +36,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>artifact_id</td><td>yes</td><td>

docs/actions/deleteRepoSecret.md

@@ -36,7 +36,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>secret_name</td><td>yes</td><td>

docs/actions/deleteRepoVariable.md

@@ -38,7 +38,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>name</td><td>yes</td><td>

docs/actions/deleteSelfHostedRunnerFromRepo.md

@@ -39,7 +39,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>runner_id</td><td>yes</td><td>

docs/actions/deleteWorkflowRun.md

@@ -38,7 +38,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>run_id</td><td>yes</td><td>

docs/actions/deleteWorkflowRunLogs.md

@@ -36,7 +36,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>run_id</td><td>yes</td><td>

docs/actions/disableWorkflow.md

@@ -38,7 +38,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>workflow_id</td><td>yes</td><td>

docs/actions/downloadArtifact.md

@@ -40,7 +40,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>artifact_id</td><td>yes</td><td>

docs/actions/downloadJobLogsForWorkflowRun.md

@@ -39,7 +39,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>job_id</td><td>yes</td><td>

docs/actions/downloadWorkflowRunAttemptLogs.md

@@ -40,7 +40,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>run_id</td><td>yes</td><td>

docs/actions/downloadWorkflowRunLogs.md

@@ -39,7 +39,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>run_id</td><td>yes</td><td>

docs/actions/enableWorkflow.md

@@ -38,7 +38,7 @@ The account owner of the repository. The name is not case sensitive.
 </td></tr>
 <tr><td>repo</td><td>yes</td><td>
 
-The name of the repository. The name is not case sensitive.
+The name of the repository without the `.git` extension. The name is not case sensitive.
 
 </td></tr>
 <tr><td>workflow_id</td><td>yes</td><td>

docs/actions/generateRunnerJitconfigForOrg.md

@@ -0,0 +1,63 @@
+---
+name: Create configuration for a just-in-time runner for an organization
+example: octokit.rest.actions.generateRunnerJitconfigForOrg({ org, name, runner_group_id, labels })
+route: POST /orgs/{org}/actions/runners/generate-jitconfig
+scope: actions
+type: API method
+---
+
+# Create configuration for a just-in-time runner for an organization
+
+Generates a configuration that can be passed to the runner application at startup.
+
+You must authenticate using an access token with the `admin:org` scope to use this endpoint.
+
+```js
+octokit.rest.actions.generateRunnerJitconfigForOrg({
+  org,
+  name,
+  runner_group_id,
+  labels,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>org</td><td>yes</td><td>
+
+The organization name. The name is not case sensitive.
+
+</td></tr>
+<tr><td>name</td><td>yes</td><td>
+
+The name of the new runner.
+
+</td></tr>
+<tr><td>runner_group_id</td><td>yes</td><td>
+
+The ID of the runner group to register the runner to.
+
+</td></tr>
+<tr><td>labels</td><td>yes</td><td>
+
+The names of the custom labels to add to the runner. **Minimum items**: 1. **Maximum items**: 100.
+
+</td></tr>
+<tr><td>work_folder</td><td>no</td><td>
+
+The working directory to be used for job execution, relative to the runner install directory.
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://docs.github.com/rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-an-organization).