Delete

[POST] .../v1/itemimage/delete

Deletes item images. Remove an item image from the active catalog image list. The method deletes the common image record referenced by id and returns row_affected; it does not delete the catalog item itself. Deleting the main item image promotes the remaining active image with the smallest ID; deleting the last image leaves the item without a main image. If file cleanup fails, the image remains removed from the catalog; retry Delete with the same id to clean up remaining files. A cleanup-only retry returns row_affected = 0. The caller must have item image delete permission, id is required and missing body, missing id, denied access, missing image records or storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
id Int64 Required Image record ID.

Request Example

{
  "id": 1001
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 1
  }
}