Check image
Checks an image as the project's environments would pull it: with the registry that covers it, if any, saying its digest and size. Refused with failed_precondition and a reason when kosem can't pull it: IMAGE_PULL_DENIED, REGISTRY_SIGN_IN_REFUSED, IMAGE_NOT_FOUND or IMAGE_TOO_LARGE; unavailable when its registry can't be reached. A registry that refuses its sign-in needs attention, and one that takes it no longer does.
Checks an image as the project's environments would pull it: with the registry that covers it, if any, saying its digest and size.
Refused with failed_precondition and a reason when kosem can't pull it: IMAGE_PULL_DENIED, REGISTRY_SIGN_IN_REFUSED, IMAGE_NOT_FOUND or IMAGE_TOO_LARGE; unavailable when its registry can't be reached. A registry that refuses its sign-in needs attention, and one that takes it no longer does.
bearerAuthorizationBearer <token>An access token, or an API key.
project*stringThe project's ID.
^prj_[0-7][0-9a-hjkmnp-tv-z]{25}$application/json- body
image*stringThe image's reference, with a tag or a digest, such as ghcr.io/acme/devbox:2026.10.
length <= 512OK
application/json- response
access*stringHow kosem pulls it: KOSEM, its own image; PUBLIC, without signing in; REGISTRY, signed in with registry.
"KOSEM""PUBLIC""REGISTRY"compressedBytes*integerThe size of the linux/amd64 image's layers and config, compressed, as its registry sends them; 0 for kosem's own image.
int64digest*stringThe digest of the manifest the reference names now, an index's for an image of several platforms; empty for kosem's own image.
image*stringThe image's reference, as checked.
pinned*stringThe reference with the digest its registry gave, keeping its tag, such as ghcr.io/acme/devbox:2026.10@sha256:…: what an agent's environment pulls once its image is set. kosem's own image as it is.
registry?stringFor REGISTRY, the registry kosem signs in with: the project's, or one its organization shares with it.
curl -X POST 'https://api.kosem.ai/v1/projects/string/images/check' \
-H 'Content-Type: application/json' \
-d '{
"image": "string"
}'{
"access": "KOSEM",
"compressedBytes": 0,
"digest": "string",
"image": "string",
"pinned": "string",
"registry": "string"
}