Images

Opaque keyset token for the next page; null on the last page.

The build's CURRENT attempt. For an adopted image this is the job that already produced it, not a job this call enqueued — so it is not evidence that a build was started. null when the image was reused and no build job is on record for it (an anonymous registry import whose pull job has been pruned): poll GET /images/{id} for status instead — the image id, not a job id, is the handle to wait on.

Home region the image is built in (PLAN-REGIONS.md).

The build's status. pending for a build this call enqueued, and building when it joined one already in flight — but ready when the image was ADOPTED from an identical build that had already finished (PLAN-BUILD-DEDUPE.md), in which case no build runs and the image is usable immediately. Poll GET /images (or the job) for progress.

Every region that holds a copy of this image's current manifest right now (PLAN-ARTIFACT-RESIDENCY.md "The copy record"); the home region is listed only while its own copy is there. Empty until the build finishes, and after every copy has been evicted. A create in a region not listed here waits while that region fetches the image from the global artifact store. A registry import whose export is not yet durable, or a create of one that carries volumes, is pulled from the registry again instead; any other create that carries volumes is refused there.

Not a column: filled in by one batched query per page.

Captured erofs layer size in bytes; null until the build completes.

The platform default image: what POST /sandboxes without image boots. Only ever true on a platform image.

A deprecated platform image: no new creates by name, not listed by GET /images?platform=…; its img_… id still resolves.

Build failure reason; null unless status is failed.

format_version is below the current format. Such an image converts on its first Linux sandbox create (which waits queued meanwhile) or ahead of time with POST /images/{id}/convert; every other door (GPU, Windows, functions, a POST /images named source) refuses it with 409 IMAGE_FORMAT_OUTDATED until then. Derived, never stored.

The image's format generation — how its artifact is stored (images::format): 1 = stored by Daytona v1 (the v1 → v2 migration registers these; nothing pulled yet), 2 = the platform's current artifact. status is the pipeline state of the artifact at this format.

Where the image was imported from (an archived Daytona v1 sandbox's backup, #3035): {platform: "v1", id: <v1 sandbox id>}. Absent (never null) when the image was not imported, so the item and the page row share one optional, non-nullable shape.

Resolved erofs manifest name; null until the build completes.

A platform image: published by the platform operator, owned by no project, and bootable by every project (PLAN-PLATFORM-IMAGES.md). A project's own image of the same name takes precedence for that project. Platform images cannot be renamed, converted or deleted through this API.

Home region the image was built in (PLAN-REGIONS.md).

The build source as stored (ImageSource JSON).

Every region that holds a copy of this image's current manifest right now (PLAN-ARTIFACT-RESIDENCY.md "The copy record"); the home region is listed only while its own copy is there. Empty until the build finishes, and after every copy has been evicted. A create in a region not listed here waits while that region fetches the image from the global artifact store. A registry import whose export is not yet durable, or a create of one that carries volumes, is pulled from the registry again instead; any other create that carries volumes is refused there.

Not a column: filled in by one batched query per page.

Captured erofs layer size in bytes; null until the build completes.

The platform default image: what POST /sandboxes without image boots. Only ever true on a platform image.

A deprecated platform image: no new creates by name, not listed by GET /images?platform=…; its img_… id still resolves.

Build failure reason; null unless status is failed.

format_version is below the current format. Such an image converts on its first Linux sandbox create (which waits queued meanwhile) or ahead of time with POST /images/{id}/convert; every other door (GPU, Windows, functions, a POST /images named source) refuses it with 409 IMAGE_FORMAT_OUTDATED until then. Derived, never stored.

The image's format generation — how its artifact is stored (images::format): 1 = stored by Daytona v1 (the v1 → v2 migration registers these; nothing pulled yet), 2 = the platform's current artifact. status is the pipeline state of the artifact at this format.

Where the image was imported from (an archived Daytona v1 sandbox's backup, #3035): {platform: "v1", id: <v1 sandbox id>}. Absent (never null) when the image was not imported, so the item and the page row share one optional, non-nullable shape.

Resolved erofs manifest name; null until the build completes.

A platform image: published by the platform operator, owned by no project, and bootable by every project (PLAN-PLATFORM-IMAGES.md). A project's own image of the same name takes precedence for that project. Platform images cannot be renamed, converted or deleted through this API.

Home region the image was built in (PLAN-REGIONS.md).

The build source as stored (ImageSource JSON).

Always deleted.

true when this call started or joined a conversion; false when the image was already at the current format and nothing was enqueued.

The image's format before the call (ImageListItem.format_version).

The image's status after the call: pending/building while it converts, or its own status when it was already at the current format.

The format the conversion targets: the current one.

Every region that holds a copy of this image's current manifest right now (PLAN-ARTIFACT-RESIDENCY.md "The copy record"); the home region is listed only while its own copy is there. Empty until the build finishes, and after every copy has been evicted. A create in a region not listed here waits while that region fetches the image from the global artifact store. A registry import whose export is not yet durable, or a create of one that carries volumes, is pulled from the registry again instead; any other create that carries volumes is refused there.

Not a column: filled in by one batched query per page.

Captured erofs layer size in bytes; null until the build completes.

The platform default image: what POST /sandboxes without image boots. Only ever true on a platform image.

A deprecated platform image: no new creates by name, not listed by GET /images?platform=…; its img_… id still resolves.

Build failure reason; null unless status is failed.

format_version is below the current format. Such an image converts on its first Linux sandbox create (which waits queued meanwhile) or ahead of time with POST /images/{id}/convert; every other door (GPU, Windows, functions, a POST /images named source) refuses it with 409 IMAGE_FORMAT_OUTDATED until then. Derived, never stored.

The image's format generation — how its artifact is stored (images::format): 1 = stored by Daytona v1 (the v1 → v2 migration registers these; nothing pulled yet), 2 = the platform's current artifact. status is the pipeline state of the artifact at this format.

Where the image was imported from (an archived Daytona v1 sandbox's backup, #3035): {platform: "v1", id: <v1 sandbox id>}. Absent (never null) when the image was not imported, so the item and the page row share one optional, non-nullable shape.

Resolved erofs manifest name; null until the build completes.

A platform image: published by the platform operator, owned by no project, and bootable by every project (PLAN-PLATFORM-IMAGES.md). A project's own image of the same name takes precedence for that project. Platform images cannot be renamed, converted or deleted through this API.

Home region the image was built in (PLAN-REGIONS.md).

The build source as stored (ImageSource JSON).