---
title: "Remove an image"
method: DELETE
path: "/images/{name}"
tags: ["Image"]
---

# Remove an image

`DELETE /images/{name}`

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.

## Path parameters

- `name` string, required

## Query parameters

- `force` boolean
- `noprune` boolean
- `platforms` string[]

## Response `200`

The image was deleted successfully

- ImageDeleteResponseItem[]
  - `Untagged` string — The image ID of an image that was untagged
  - `Deleted` string — The image ID of an image that was deleted

## Other responses

- `404` — No such image
- `409` — Conflict
- `500` — Server error

---

[API](https://skmtc.net/moby/apis/docker-engine-api.md) · [All operations](https://skmtc.net/moby/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moby/docker-engine-api/revisions/4752769870da/schema)