---
title: "DELETE /images/{name}"
method: DELETE
path: "/images/{name}"
---

# DELETE /images/{name}

`DELETE /images/{name}`

Remove an image

## Path parameters

- `name` string, required

## Query parameters

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

## Response `200`

The request has succeeded.

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

## Changes

- **2026-02-14** `31f80d10d31a` — 2 breaking, 4 info
  - for the `query` request parameter `force`, default value `false` was removed
  - for the `query` request parameter `noprune`, default value `false` was removed
  - api tag `Image` removed
  - removed the non-success response with the status `404`
  - …2 more

[Change history](https://skmtc.dev/hexlet/apis/docker-engine-api/changes/images/:name/delete.md)

---

[API](https://skmtc.dev/hexlet/apis/docker-engine-api.md) · [All operations](https://skmtc.dev/hexlet/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexlet/docker-engine-api/revisions/7dbd508c79cf/schema)