v56

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

actions

List image versions of a custom image for an enterprise

List image versions of a custom image for an enterprise.

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

Path parameters

image_definition_idinteger required

Image definition ID of custom image

enterprisestring required

The slug version of the enterprise name.

Response

total_countinteger required

Example response

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