v1

latestSwagger 2.02026-07-17108109409.0 KB
Image

Remove an image

Remove an image, along with any untagged parent images that were referenced by that image.

Images can't be removed if they have descendant images, are being used by a running container or are being used by a build.

delete/images/{name}

Path parameters

namestring required

Image name or ID

Query parameters

forceboolean

Remove the image even if it is being used by stopped containers or has other tags

nopruneboolean

Do not delete untagged parent images

Response

The image was deleted successfully

Untaggedstring

The image ID of an image that was untagged

Deletedstring

The image ID of an image that was deleted