Get image

Gets a build or imported image version

Required permission

Project > Images > General > Read

Path parameters

projectId
string required
ID of the project
imageId
string required
Object ID of the image version

Response body

{object}
Response object.

data
{object} required
Result data.

id
string required
min length
24
max length
24
name
string required
tag
string required
source
(multiple options: anyOf) required

{object}

type
string required
one of
build
buildId
string required
min length
24
max length
24
nfObjectId
string required
min length
24
max length
24
nfObjectType
string required
one of
service, job
branch
string required

OR

{object}

type
string required
one of
imported
from
string required
one of
ui, external, registry

group
(multiple options: oneOf)

string

ready
boolean required
status
string required
one of
AWAITING_UPLOAD, IMPORTING, VALIDATING, READY, FAILURE, EXPIRED
createdAt
string required
publishedAt
string
digest
string
pattern
^sha256:[a-f0-9]{64}$
supportedArchitectures
[array]

string
one of
linux/amd64, linux/arm64

imageSizeBytes
integer
validationError
string
reservationExpiresAt
string
git
{object}

provider
string required
repo
string required
branch
string required
commit
string required

GET /v1/projects/{projectId}/images/{imageId}

GET /v1/teams/{teamId}/projects/{projectId}/images/{imageId}

Example response

200 OK

Details about the image version.

JSON

© 2026 Northflank Ltd. All rights reserved.

northflank.com / Terms / Privacy / feedback@northflank.com