List image versions of a custom image for an organization

GET

/orgs/{org}/actions/hosted-runners/images/custom/{image_definition_id}/versions

List image versions of a custom image for an organization.

OAuth tokens and personal access tokens (classic) need the manage_runners:org scope to use this endpoint.

API method documentation

Parameters

Path Parameters

image_definition_id

required

integer

Image definition ID of custom image

org

required

string

The organization name. The name is not case sensitive.

Responses

200

Response

Media type application/json

object

total_count

required

integer

image_versions

required

Array<object>

GitHub-hosted runner custom image version details.

Provides details of a hosted runner custom image version

object

version

required

The version of image.

string

state

required

The state of image version.

string

size_gb

required

Image version size in GB.

integer

created_on

required

The creation date time of the image version.

string

state_details

required

The image version status details.

string

Examples

Example default

{
  "total_count": 2,
  "image_versions": [
    {
      "version": "1.1.0",
      "size_gb": 75,
      "state": "Ready",
      "created_on": "2024-11-09T23:39:01Z"
    },
    {
      "version": "1.0.0",
      "size_gb": 75,
      "state": "Ready",
      "created_on": "2024-11-08T20:39:01Z"
    }
  ]
}