Create image in organization
Creates an image, which kosem prepares so that the environments that run it start and read its files faster. The image is checked as its organization's or project's environments would pull it, and refused as CheckImage refuses one. Its size counts against the organization's quota.
Creates an image, which kosem prepares so that the environments that run it start and read its files faster.
The image is checked as its organization's or project's environments would pull it, and refused as CheckImage refuses one. Its size counts against the organization's quota.
bearerAuthorizationBearer <token>An access token, or an API key.
organization*stringThe organization's ID.
^org_[0-7][0-9a-hjkmnp-tv-z]{25}$application/json- body
availability?For an organization's image: the projects whose environments use it. None, unless set. Setting it also takes environments.images.setAvailability.
displayName*stringWhat people call the image.
1 <= length <= 100followTag?booleanWhether kosem resolves its tag again every hour; true unless set.
keepVersions?integerHow many of its newest versions it keeps, from 1 to 10; 3 unless set.
int321 <= value <= 10source*stringThe image's reference, with a tag or a digest, such as ghcr.io/acme/devbox:2026.10. Unique in its organization or project.
length <= 512Created
application/json- response
availability*For an organization's image: the projects whose environments use it. A project's image is available to none.
checkTime?stringWhen kosem last resolved its source; unset until it has.
date-timecreateTime*stringWhen the image was created.
date-timedisplayName*stringWhat people call the image.
followTag*booleanWhether kosem resolves its tag again every hour, as RefreshImage does, so that it prepares each new version. A source named by a digest never moves.
keepVersions*integerHow many of its newest versions it keeps. An older one is deleted once no environment runs it.
int32name*stringResource name, organizations/{organization_id}/images/{image_id} or projects/{project_id}/images/{image_id}.
refreshReason*stringWhy kosem's last check of its tag couldn't refresh it, which leaves it as it was; empty once a check can.
registry?stringThe registry that kosem signs in with to pull it, when it's private.
source*stringThe image's reference, with a tag or a digest, in its shortest spelling, such as node:24 for docker.io/library/node:24. Set when the image is created, and never changed.
state*stringPREPARING until its latest version is ready to run, READY once it is, and FAILED if kosem can't prepare it.
"PREPARING""READY""FAILED"stateReason*stringWhy kosem can't prepare it, when it can't.
updateTime*stringWhen the image last changed.
date-timeversions*array<>What its source named each time it was resolved, newest first.
curl -X POST 'https://api.kosem.ai/v1/organizations/string/images' \
-H 'Content-Type: application/json' \
-d '{
"displayName": "string",
"source": "string"
}'{
"availability": {
"allProjects": true,
"projects": [
"string"
]
},
"checkTime": "2019-08-24T14:15:22Z",
"createTime": "2019-08-24T14:15:22Z",
"displayName": "string",
"followTag": true,
"keepVersions": 0,
"name": "string",
"refreshReason": "string",
"registry": "string",
"source": "string",
"state": "PREPARING",
"stateReason": "string",
"updateTime": "2019-08-24T14:15:22Z",
"versions": [
{
"createTime": "2019-08-24T14:15:22Z",
"digest": "string",
"environments": 0,
"prepareTime": "2019-08-24T14:15:22Z",
"sizeBytes": 0
}
]
}