[comment]: # ({991d071b-991d071b})
# history.clear

[comment]: # ({/991d071b-991d071b})

[comment]: # ({7c7c67ac-3bf9d0da})
### Описание

`object history.clear(массив itemids)`

Этот метод позволяет очистить историю элемента.

::: noteclassic
Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/7c7c67ac-3bf9d0da})

[comment]: # ({f449cc26-f449cc26})
### Параметры

`(array)` ID элементов для очистки.

[comment]: # ({/f449cc26-f449cc26})

[comment]: # ({a59d9134-a59d9134})
### Возвращаемые значения

`(object)` Возвращает объект, содержащий идентификаторы
очищенных элементов в свойстве `itemids`.

[comment]: # ({/a59d9134-a59d9134})

[comment]: # ({b41637d2-b41637d2})
### Примеры

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({c73cef81-e482fed3})
#### Очистка истории

[Запрос](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "history.clear",
    "params": [
        "10325",
        "13205"
    ],
    "id": 1
}
```

Ответ:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "10325",
            "13205"
        ]
    },
    "id": 1
}
```

[comment]: # ({/c73cef81-e482fed3})

[comment]: # ({e7aa34e8-e7aa34e8})
### Источник

CHistory::clear() в *ui/include/classes/api/services/CHistory.php*.

[comment]: # ({/e7aa34e8-e7aa34e8})