delete
Deletes campaigns.## Learn more
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 method.
Request
Request structure in JSON format:
{
"method": "delete",
"params": { /* params */
"SelectionCriteria": { /* IdsCriteria */
"Ids": [(long), ... ] /* required */
} /* required */
}
}
Parameter |
Type |
Description |
Required |
params structure (for JSON) / DeleteRequest structure (for SOAP) |
|||
|
IdsCriteria |
Criteria for selecting campaigns to delete. |
Yes |
IdsCriteria structure |
|||
|
array of long |
IDs of campaigns to delete (maximum of 1000). |
Yes |
Response
Response structure in JSON format:
{
"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) |
||
|
array of ActionResult |
Results of deleting campaigns. |
ActionResult structure |
||
|
long |
ID of the deleted campaign. Returned if there aren't any errors. See the section Operations on object arrays. |
|
array of ExceptionNotification |
Warnings that occurred during the operation. |
|
array of ExceptionNotification |
Errors that occurred during the operation. |