Skip to main content
POST
Typescript (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json

Register a container image by reference.

name
string
required
source
string
required

Registry reference or public URL to register (ideally digest-pinned).

digest
string | null

Optional explicit content digest (sha256: or bare hex); cross-checked against a digest-pinned source.

Response

Registered.

A registered container image, usable by BYO deployments and recipes.

created_at
string<date-time>
required
digest
string
required

Content digest (sha256:). Empty until resolved.

error
string | null
required
id
string
required
name
string
required
source
string
required

Registry reference or URL the image was registered from.

status
enum<string>
required
Available options:
pending,
ready,
failed