---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://www.yandex.ru/dev/direct/doc/en/modify.md
  - https://www.yandex.ru/dev/direct/doc/ru/modify.md
  - href: https://www.yandex.ru/dev/direct/doc/ru/modify.md
    type: text/markdown
    title: Markdown version
  - href: https://www.yandex.ru/dev/direct/doc/ru/llms.txt?revision=r21714029
    rel: describedby
sourcePath: ru/start/modify.md
title: Как вносить изменения через API Директа — API Яндекс Директа
description: Как вносить изменения через API Директа — методы add, update и delete, обработка ошибок и редактирование отдельных параметров объектов.
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.ru/dev/direct/doc/ru/llms.txt?revision=r21714029


# Урок 7. Как вносить изменения через API



Все методы, изменяющие данные, — например, методы `add`, `update`, `delete` — принимают на вход массив объектов. Каждый объект в запросе обрабатывается отдельно. Например, если приложение отправило запрос на создание 100 объявлений и в 10 из них возникла ошибка, то остальные 90 объявлений будут успешно созданы. Сервер API вернет идентификаторы для 90 созданных объявлений и ошибки для остальных 10.

{% note alert %}

Идентификатор объекта возвращается только в случае успешного выполнения операции (при этом могут быть также выданы предупреждения).

{% endnote %}

![](_assets/modify_method_scheme.png){.border-yes}

Ошибки, исключающие возможность выполнения запроса (например, неверный формат или отсутствие обязательного параметра), приведут к полному отклонению запроса.

Ваше приложение должно учитывать это при взаимодействии с API и корректно обрабатывать возвращаемые сервером ошибки.

## Как редактировать параметры объектов {#modify_red_obj_params}

При изменении объекта с помощью метода `update` нет необходимости передавать все параметры объекта. Достаточно указать идентификатор объекта и те параметры, которые требуется изменить. Остальные параметры изменены не будут. При этом сервер Директа все равно проверит объект целиком и, если с новыми значениями объект некорректен, вернет ошибку.