---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.1
alternate:
  - https://yandex.com/dev/direct/doc/en/campaigns/delete.md
  - https://yandex.com/dev/direct/doc/ru/campaigns/delete.md
  - href: https://yandex.com/dev/direct/doc/en/campaigns/delete.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/direct/doc/en/llms.txt?revision=r22022696
    rel: describedby
sourcePath: en/ref-v5/campaigns/delete.md
title: delete
description: Deletes campaigns — maximum of 1000 campaigns per call, campaigns with funds, statistics, or certain statuses cannot be deleted and should be archived instead
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt?revision=r22022696


# delete

Deletes campaigns.

## Learn more

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

## Restrictions {#restrictions}

Maximum of 1000 campaigns per method call.

Campaigns can't be deleted in the following cases:

- The campaign received funds or has invoices for payment.
- The campaign had impressions and has accumulated statistics.
- The campaign is currently being activated or paused.
- The campaign has the CONVERTED status.

For these types of campaigns, archiving is available using the [archive](https://yandex.com/dev/direct/doc/en/campaigns/archive.md) method.

## Request {#input}

Request structure in JSON format:

```javascript translate=no
{
  "method": "delete",
  "params": { /* params */
    "SelectionCriteria": {  /* IdsCriteria */
      "Ids": [(long), ... ] /* required */
    } /* required */
  }
}
```

#|
||
**Parameter**
|
**Type**
|
**Description**
|
**Required**
||

||
**params structure (for JSON) / DeleteRequest structure (for SOAP)**
||
||
`SelectionCriteria`
|
IdsCriteria
|
Criteria for selecting campaigns to delete.
|
Yes
||

||
**IdsCriteria structure**
||
||
`Ids`
|
array of long
|
IDs of campaigns to delete (maximum of 1000).
|
Yes
||
|# 


## Response {#output}

Response structure in JSON format:

```javascript translate=no
{
  "result": {  /* result */
    "DeleteResults": [{  /* ActionResult */
      "Id": (long),
      "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 ActionResult
|
Results of deleting campaigns.
||

||
**ActionResult structure**
||
||
`Id`
|
long
|
ID of the deleted campaign. Returned if there aren't any errors. See the section [Operations on object arrays](https://yandex.ru/dev/direct/doc/en/best-practice/modify).
||
||
`Warnings`
|
array of [ExceptionNotification](https://yandex.ru/dev/direct/doc/en/best-practice/modify)
|
Warnings that occurred during the operation.
||
||
`Errors`
|
array of [ExceptionNotification](https://yandex.ru/dev/direct/doc/en/best-practice/modify)
|
Errors that occurred during the operation.
||
|#