---
title: "Get image details"
method: GET
path: "/images/{name}"
---

# Get image details

`GET /images/{name}`

## Path parameters

- `name` string, required

## Response `200`

Image details

- Image
  - `name` string, required — Normalized OCI image reference (tag or digest)
  - `digest` string, required — Resolved manifest digest
  - `platform` string — Resolved image platform as os/arch[/variant] (e.g. "linux/amd64")
  - `status` 'pending' | 'pulling' | 'converting' | 'ready' | 'failed', required — Build status
  - `queue_position` integer, nullable — Position in build queue (null if not queued)
  - `error` string, nullable — Error message if status is failed
  - `size_bytes` integer, nullable — Disk size in bytes (null until ready)
  - `entrypoint` string[], nullable — Entrypoint from container metadata
  - `cmd` string[], nullable — CMD from container metadata
  - `env` object — Environment variables from container metadata
  - `tags` Tags — User-defined key-value tags.
  - `working_dir` string, nullable — Working directory from container metadata
  - `created_at` string, date-time, required — Creation timestamp (RFC3339)

## Other responses

- `404` — Image not found
- `500` — Internal server error

---

[API](https://skmtc.net/kernel/apis/hypeman-api.md) · [All operations](https://skmtc.net/kernel/apis/hypeman-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/hypeman-api/versions/b4642bb950dc/schema)