Sign in

v56

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

Delete a GitHub-hosted runner for an organization

Deletes a GitHub-hosted runner for an organization.

delete/orgs/{org}/actions/hosted-runners/{hosted_runner_id}

Path parameters

orgstring required

The organization name. The name is not case sensitive.

hosted_runner_idinteger required

Unique identifier of the GitHub-hosted runner.

Response

Response

idinteger required

The unique identifier of the hosted runner.

namestring required

The name of the hosted runner.

runner_group_idinteger

The unique identifier of the group that the hosted runner belongs to.

status'Ready' | 'Provisioning' | 'Shutdown' | 'Deleting' | 'Stuck' required

The status of the runner.

platformstring required

The operating system of the image.

maximum_runnersinteger

The maximum amount of hosted runners. Runners will not scale automatically above this number. Use this setting to limit your cost.

public_ip_enabledboolean required

Whether public IP is enabled for the hosted runners.

last_active_onstring date-time nullable

The time at which the runner was last used, in ISO 8601 format.

image_genboolean

Whether custom image generation is enabled for the hosted runners.

Example response

{
  "id": 5,
  "name": "my-github-hosted-runner",
  "runner_group_id": 2,
  "image_details": {
    "id": "ubuntu-20.04",
    "size_gb": 86,
    "version": "latest"
  },
  "machine_size_details": {
    "id": "8-core",
    "cpu_cores": 8,
    "memory_gb": 32,
    "storage_gb": 300
  },
  "status": "Ready",
  "platform": "linux-x64",
  "maximum_runners": 5,
  "public_ip_enabled": true,
  "public_ips": [
    {
      "enabled": true,
      "prefix": "20.80.208.150",
      "length": 28
    }
  ],
  "last_active_on": "2022-10-09T23:39:01Z"
}