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}
Request
- Base URL/v1.49 (relative, and the document was published on a file host, not at the API’s origin)
- URL/v1.49/images/{name}
- Authnone declared
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
Changes
No recorded changes to this operation across all 4 revisions of this API.