v56

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

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

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

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

get/enterprises/{enterprise}/actions/hosted-runners/images/custom/{image_definition_id}/versions/{version}

Path parameters

enterprisestring required

The slug version of the enterprise name.

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