---
title: "Get an enterprise custom image definition for GitHub Actions Hosted Runners"
method: GET
path: "/enterprises/{enterprise}/actions/hosted-runners/images/custom/{image_definition_id}"
tags: ["actions"]
---

# Get an enterprise custom image definition for GitHub Actions Hosted Runners

`GET /enterprises/{enterprise}/actions/hosted-runners/images/custom/{image_definition_id}`

Get an enterprise custom image definition for GitHub Actions Hosted Runners.

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

## Path parameters

- `enterprise` string, required
- `image_definition_id` integer, required

## Response `200`

Response

- ActionsHostedRunnerCustomImage — Provides details of a custom runner image
  - `id` integer, required — The ID of the image. Use this ID for the `image` parameter when creating a new larger runner.
  - `platform` string, required — The operating system of the image.
  - `total_versions_size` integer, required — Total size of all the image versions in GB.
  - `name` string, required — Display name for this image.
  - `source` string, required — The image provider.
  - `versions_count` integer, required — The number of image versions associated with the image.
  - `latest_version` string, required — The latest image version associated with the image.
  - `state` string, required — The number of image versions associated with the image.

---

[API](https://skmtc.net/github/apis/enterprise-cloud.md) · [All operations](https://skmtc.net/github/apis/enterprise-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/enterprise-cloud/revisions/daeba3129b5f/schema)