v2

latestOpenAPI 3.1.02026-07-2675166192.8 KB
Images

Update Images

Update one or many logical images: visibility, name/tag, and owner.

Applies up to 100 independent patches; each item names its source image exactly and may change visibility, rename name/tag, move a personal image into one of the caller's teams, or promote a personal/team image to an org-less platform image (platform admins only; platform images are always PUBLIC).

Renames and owner moves update the whole logical group (container + VM artifacts and their linked builds) atomically without moving the backing artifacts: the old reference stops resolving and the new reference resolves to the same content. An owner move settles storage billing to the source wallet at the cutover instant and bills the destination afterwards. Destinations are never overwritten (destination_exists).

dryRun performs resolution, authorization, collision detection, and quota projection without writing; a valid request with item-specific failures still returns 200 with per-item errors.

patch/api/v1/images

Request body

mode'explicit'
dryRunboolean

Response

Successful Response

successboolean required

True only when every item succeeded

dryRunboolean required