---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/adimages/delete.md
  - https://yandex.com/dev/direct/doc/ru/adimages/delete.md
  - href: en/adimages/delete.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/ref-v5/adimages/delete.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt

# delete

Deletes images.

## Learn more

- [How the "delete" method works](https://yandex.com/dev/direct/doc/dg/best-practice/modify.html)
- [How to handle errors](https://yandex.com/dev/direct/doc/en/concepts/errors)


## Restrictions {#restrictions}

Maximum of 10,000 images per method call.

If an image is assigned to an ad, it can't be deleted.


## Request {#input}

Request structure in JSON format:

```javascript
{
  "method": "delete",
  "params": {
    "SelectionCriteria": {  /* AdImageIdsCriteria */
      "AdImageHashes": [(string), ... ] /* required */
    } /* required */
  }
}
```


#|
||
**Parameter** 
|
**Type** 
|
**Description** 
|
**Required**
||
||
**params structure (for JSON) / DeleteRequest structure (for SOAP)**
|
>
|
>
|
>||
||
`SelectionCriteria`
|
AdImageIdsCriteria
|
Criteria for selecting images to delete.
|
Yes
||
||
**AdImageIdsCriteria structure**
|
>
|
>
|
>||
||
`AdImageHashes`
|
array of string
|
Hashes of images to be deleted (maximum of 10,000).
|
Yes
||
|# 


## Response {#output}

Response structure in JSON format:

```javascript
{
  "result": {  /* result */
    "DeleteResults": [{  /* AdImageActionResult */
      "AdImageHash": (string),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ]
    }, ... ] /* required */
  }
}
```


#|
||
**Parameter** 
|
**Type** 
|
**Description** 
||
||
**result structure (for JSON) / DeleteResponse structure (for SOAP)**
|
>
|
>
||
||
`DeleteResults`
|
array of AdImageActionResult
|
Results of deleting images.
||
||
**AdImageActionResult structure**
|
>
|
>
||
||
`AdImageHash`
|
string
|
Hash of the deleted image. Returned if there aren't any errors. See the section [Operations on object arrays](https://yandex.com/dev/direct/doc/dg/best-practice/modify.html).
||
||
`Warnings`
|
array of ExceptionNotification
|
Warnings that occurred during the operation.
||
||
`Errors`
|
array of ExceptionNotification
|
Errors that occurred during the operation.
||
|#