---
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/en/modify.md
    type: text/markdown
    title: Markdown version
  - href: https://www.yandex.ru/dev/direct/doc/en/llms.txt?revision=r21714029
    rel: describedby
sourcePath: en/start/modify.md
title: How to make changes via the API — Yandex Direct API
description: How to make changes via Yandex Direct API — add, update, and delete methods, handling errors, and editing individual object parameters.
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.ru/dev/direct/doc/en/llms.txt?revision=r21714029


# Lesson 7. How to make changes via the API

All the data-changing methods, such as `add`, `update`, `delete`, accept an array of objects as an input. Each object contained in the request is processed separately. For example, if your app has sent a request to create 100 ads and an error has occurred to 10 of them, the other 90 ads are created successfully. The API server returns IDs for the 90 ads created, and errors for the other 10 ads.

{% note alert %}

The object ID is returned only if the operation has been completed successfully (warnings may also be issued).

{% endnote %}

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

If errors preclude request execution (for example, their format is invalid or a required parameter is missing), the request is rejected completely.

Your application must account for this while interacting with the API, to properly handle the errors returned by the server.f

## How to edit object parameters {#modify_red_obj_params}

When using the `update` method to change an object, you do not have to pass all the object parameters. You only have to specify the object ID and the parameters to be changed. The other parameters won't change. The Yandex Direct server will check anyway the entire object and return an error if the new parameter values have invalidated the object.