v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,21696712.2 MB
actions

Create configuration for a just-in-time runner for a repository

Generates a configuration that can be passed to the runner application at startup.

The authenticated user must have admin access to the repository.

OAuth tokens and personal access tokens (classic) need therepo scope to use this endpoint.

post/repos/{owner}/{repo}/actions/runners/generate-jitconfig

Path parameters

ownerstring required

The account owner of the repository. The name is not case sensitive.

repostring required

The name of the repository without the .git extension. The name is not case sensitive.

Request body

namestring required

The name of the new runner.

runner_group_idinteger required

The ID of the runner group to register the runner to.

labelsstring[] required

The names of the custom labels to add to the runner. Minimum items: 1. Maximum items: 100.

work_folderstring

The working directory to be used for job execution, relative to the runner install directory.

Response

Response

encoded_jit_configstring required

The base64 encoded runner configuration.

Example response

{
  "runner": {
    "id": 5,
    "runner_group_id": 1,
    "name": "iMac",
    "os": "macos",
    "status": "online",
    "version": "2.323.0"
  }
}