---
title: "Delete image by docker imageId"
method: DELETE
path: "/images/by_id/{imageId}"
tags: ["Images"]
---

# Delete image by docker imageId

`DELETE /images/by_id/{imageId}`

## Path parameters

- `imageId` string, required

## Query parameters

- `force` boolean

## Headers

- `x-anchore-account` string

## Response `200`

Image deletion success

- DeleteImageResponse — Image deletion response containing status and details
  - `digest` string, required
  - `status` 'not_found' | 'deleting' | 'delete_failed', required — Current status of the image deletion
  - `detail` string

## Other responses

- `500` — Internal error

---

[API](https://skmtc.net/anchore/apis/anchore-engine-api-server.md) · [All operations](https://skmtc.net/anchore/apis/anchore-engine-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchore/anchore-engine-api-server/versions/afb4f60ab44a/schema)