Sign in

v68

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

Get an image version of a custom image for GitHub Actions Hosted Runners

Get an image version of a custom image for GitHub Actions Hosted Runners.

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

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

Path parameters

orgstring required

The organization name. The name is not case sensitive.

image_definition_idinteger required

Image definition ID of custom image

versionstring required

Version of a custom image

Response

Response

versionstring required

The version of image.

statestring required

The state of image version.

size_gbinteger required

Image version size in GB.

created_onstring required

The creation date time of the image version.

state_detailsstring required

The image version status details.

Example response

{
  "version": "1.0.0",
  "state": "Ready",
  "size_gb": 30,
  "created_on": "2024-11-09T23:39:01Z",
  "state_details": "None"
}