---
title: "retrieve a given image"
method: GET
path: "/images/{imageName}"
tags: ["images"]
---

# retrieve a given image

`GET /images/{imageName}`

Requires the privilege [`IMAGES_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `imageName` string, required

## Query parameters

- `teamId` string, required

## Response `200`

The requested image

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: IMAGES_READ
- `404` — Not found

## Changes

- **2026-09-02** `358b43b8f258` — 2 info
  - added the non-success response with the status `404`
  - added the success response with the status `200`

[Change history](https://skmtc.dev/gremlin/apis/gremlin-api/changes/images/:imageName/get.md)

---

[API](https://skmtc.dev/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.dev/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/358b43b8f258/schema)