---
title: "List custom images for an enterprise"
method: GET
path: "/enterprises/{enterprise}/actions/hosted-runners/images/custom"
tags: ["actions"]
---

# List custom images for an enterprise

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

List custom images for an enterprise.

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

## Path parameters

- `enterprise` string, required

## Response `200`

Response

- object
  - `total_count` integer, required
  - `images` ActionsHostedRunnerCustomImage[], required
    - `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/github-v3-rest-api-3.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-3/versions/dc0584ac4e13/schema)