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

# Suspend
Pauses impressions for keywords. The keywords may be for different campaigns or ad groups.

{% note alert %}

Disabled method. Use version 5 of the API.

For information about the compatibility of methods between versions Live 4 and 5, see the [Migration guide](https://yandex.com/dev/direct/doc/migration/concepts/methods.md).

{% endnote %}


## Restrictions


{% note alert %}

This method only supports campaigns with the “Text & Image Ads” type. To manage keywords in all types of campaigns, use the [Keywords](https://yandex.com/dev/direct/doc/ref-v5keywords/keywords.md) service in version 5 of the API.

{% endnote %}


For an ad group, at least one keyword or retargeting condition must be active. When trying to stop all active keywords in a group (when there aren't any active retargetings), an error will be output for each of these keywords with the code [195](https://yandex.com/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#ErrorCode195) (this error does not cause the entire operation to be canceled and does not affect the success of stopping keywords that are related to other groups).

## Input data

The input data structure in JSON is shown below.

```javascript
{
   "method": "Keyword",
   "param": {
      /* KeywordRequest */
      "Action": (string),
      "Login": (string),
      "KeywordIDS": [
         (long)
         ...
      ]
   }
}
```

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
|
**<sup >Required</sup>**
||

||
**<sub >KeywordRequest object</sub>**
||
||
`Action`
|
Action: Suspend.
|
Yes
||
||
`Login`
|
The username of the client to perform the operation for.

A direct advertiser can optionally specify the username of a [chief representative](https://yandex.ru/support/direct/campaigns/representatives.xml)[chief representative](https://yandex.com/support/direct/campaigns/representatives.xml).
|
For agencies
||
||
`KeywordIDS`
|
Array of keywords IDs (maximum 10,000).
|
Yes
||
|#

## Output data


{% note info %}

Errors that occur when pausing individual keywords ([54](https://yandex.com/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#ErrorCode54) if the user doesn't have editing permissions for the keyword, [194](https://yandex.com/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#ErrorCode194), and [195](https://yandex.com/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#ErrorCode195)) do not cause the entire operation to be canceled and do not affect the success of pausing other keywords.

{% endnote %}


The output data structure in JSON is shown below.

```javascript
{
   "data": {
      /* KeywordResponse */
      "ActionsResult": [
         {  /* KeywordActionResult */
            "Warnings": [
               {  /* Warning */
                  "WarningCode": (int),
                  "WarningString": (string),
                  "Description": (string)
               }
               ...
            ],
            "Errors": [
               {  /* Error */
                  "FaultCode": (int),
                  "FaultString": (string),
                  "FaultDetail": (string)
               }
               ...
            ],
            "KeywordID": (long)
         }
         ...
      ]
   }
}
```

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
||

||
**<sub >KeywordResponse object</sub>**
||
||
`ActionsResult`
|
Array of `KeywordActionResult` objects. Each object corresponds to an item in the `KeywordIDS` input array and contains:
- Keyword ID.
- Array of `Errors` or array of `Warnings` if they occurred when executing the operation on this keyword.
||

||
**<sub >KeywordActionResult object</sub>**
||
||
`Warnings`
|
Array of `Warning` objects describing issues that occurred while performing the operation.
||
||
`Errors`
|
Array of `Error` objects with errors that occurred while performing the operation.
||
||
`KeywordID`
|
Keyword ID.
||

||
**<sub >Warning object</sub>**
||
||
`WarningCode`
|
Warning code: [212](https://yandex.com/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#warning212).
||
||
`WarningString`
|
Warning text.
||
||
`Description`
|
Contains an empty structure.
||

||
**<sub >Error object</sub>**
||
||
`FaultCode`
|
Error code.
||
||
`FaultString`
|
Textual message about the error.
||
||
`FaultDetail`
|
Detailed description of the reason for the error.
||
|#

## Examples of input data

# Python

```python
{
   'Action': 'Suspend',
   'Login': 'agrom',
   'KeywordIDS': [199381759,199482870,200725193]
}
```

# PHP

```php
array(
   'Action' => 'Suspend',
   'Login' => 'agrom',
   'KeywordIDS' => array(199381759,199482870,200725193)
)
```

# Perl

```perl
{
   'Action' => 'Suspend',
   'Login' => 'agrom',
   'KeywordIDS' => [199381759,199482870,200725193]
}
```