v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB

actions

Create configuration for a just-in-time runner for an organization

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

The authenticated user must have admin access to the organization.

OAuth tokens and personal access tokens (classic) need theadmin: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.

post/orgs/{org}/actions/runners/generate-jitconfig

Path parameters

orgstring required

The organization name. 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

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"
  }
}