Container Registry API: schemas

The request and response bodies of the operations in this API.

CreateWorkspaceImageVariantDto

PropertyTypeRequiredDescription
autoRebakebooleanno
baseImagestringyesBase image tag or digest. The service resolves the immutable digest at bake time.
descriptionstringyes
isOrgDefaultbooleanno
manifestobjectyesWorkspaceImageManifest JSON. Validated server-side against the typed schema.
regionsarray of stringnoRegions to replicate the baked image into. Empty = global. v1 records only — orchestrator does not yet select on region.
runtimeKindstringyesRuntime id the variant targets (a worker runtime adapter contributes the id). Drives which kernel base image cascade applies.
slugstringyesStable per-org slug used as the variant identity in the orchestrator cascade.

ListWorkspaceImageVariantsResponseDto

PropertyTypeRequiredDescription
variantsarray of WorkspaceImageVariantDtoyes

ResolveOrgDefaultResponseDto

PropertyTypeRequiredDescription
variantWorkspaceImageVariantDto or nullyesThe resolved workspace image variant, or null when none matches.

UpdateWorkspaceImageVariantDto

PropertyTypeRequiredDescription
autoRebakebooleanno
descriptionstringno
isOrgDefaultbooleanno
regionsarray of stringno

VariantStatus

Type: one of "draft", "building", "ready", "failed", "archived"

WorkspaceImageVariantDto

PropertyTypeRequiredDescription
autoRebakebooleanyes
baseImagestringyes
buildLogobject or nullno
builtAtstring (date-time) or nullno
contentHashstringyes
createdAtstring (date-time)yes
descriptionstringyes
idstringyes
isOrgDefaultbooleanyes
manifestobjectyes
orgIdstringyes
regionsarray of stringyes
registryRefobject or nullno
runtimeKindstringyes
slugstringyes
statusVariantStatusyes
updatedAtstring (date-time)yes