# ImageStatus


[API catalog](/reference/api/) · [Docker Sandboxes overview](/reference/api/sandboxes/latest/) · [Product manual](https://docs.docker.com/ai/sandboxes-api/) · [OpenAPI specification](/reference/api/sandboxes/api.yaml)

API version: v1


> This API is experimental. Features, interfaces,
> and behavior may change.




Schema constraints and annotations:

```json
{
  "description": "ImageStatus is the image readiness state.\n\nValues:\nunspecified: unspecified is never a concrete known state.\npending: pending means an asynchronous build has not started or reported progress.\nwaitingForPush: waitingForPush means the backend is waiting for OCI content upload.\npreparing: preparing means the backend is preparing pushed or captured content.\ncompleted: completed means the image is ready to use.\nfailed: failed means image preparation reached a terminal failure.\ndeleted: deleted means the backend exposes a retained delete tombstone.",
  "enum": [
    "unspecified",
    "pending",
    "waitingForPush",
    "preparing",
    "completed",
    "failed",
    "deleted"
  ],
  "title": "ImageStatus",
  "type": "string"
}
```