---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://yandex.com/dev/partner-objects/doc/en/reference/post-resource-id.md
  - https://yandex.com/dev/partner-objects/doc/ru/reference/post-resource-id.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/partner-objects/doc/ru/llms.txt


# POST/{resource-id}

Добавляет новый объект в указанный ресурс.

## Формат запроса {#input}

```
POST https://jsonapi.partner2.yandex.com/vX/{resource-id}
```

#|
|| **Параметр** | **Описание** ||
|| `resource-id`
| Идентификатор ресурса, в который необходимо добавить новый объект.
||
|#


## Формат тела запроса {#structure-in}

## JSON

```json
{
  "data": 
    {
      "type": "{string}",
      "attributes": {
        "brands": [
          {
            "bid": "{string}",
            "blocked": {boolean},
            "cpm": {integer}
          },
          {
            ...
          }
        ],
        "client_id": {integer},
        "email": "{string}",
        "excluded_domains": ["{string}"],
        "excluded_phones": ["{string}"],
        "geo": [
          {
            "id": "{string}",
            "cpm": {integer}
          },
          {
            ...
          }
        ]
      }
    }
}           
```

При создании блоков через API необходимо явно указывать настройки медийного дизайна.

Пример: 
```
 
"design_templates":[
  {
    "caption":"Media design",
    "type":"media",
    "design_settings":
    {
      "filterSizes":false,
      "horizontalAlign":true
    }
  }
],

```

## Параметры тела запроса {#spec-in}

- **data** [*](*Обязательный_параметр) Объект с параметрами.

  - **type** [*](*Обязательный_параметр) Тип ресурса.

  - **attributes** [*](*Обязательный_параметр) Параметры объекта.

      {% note alert "Ограничение." %}

      Допустимые значения зависят от ресурса, к которому относится объект, и перечислены в параметре `editable_fields` операции [GET/{resource-id}/{object-id}](https://yandex.com/dev/partner-objects/doc/ru/reference/get-resource-id-object-id.md). Ниже, для примера, приведена часть параметров.

      {% endnote %}

    - **brands** Бренды, установленные на текущем объекте.

      - **bid** Минимальная ставка, необходимая для показа бренда (в рублях).

      - **blocked** Бренд заблокирован (`true` или `false`).

      - **cpm** Минимальный CPM, необходимый для показа в текущем регионе (в рублях).

    - **client_id** Идентификатор клиента.

    - **email** Электронная почта клиента.

    - **excluded_domains** Исключенные домены.

    - **excluded_phones** Исключенные телефоны.

    - **geo** Региональные таргетинги, установленные на текущем объекте.

      - **id** Идентификатор региона. Узнать регион можно с помощью операции [GET/{resource-id}](https://yandex.com/dev/partner-objects/doc/ru/reference/get-resource-id.md).

      - **cpm** Минимальный CPM, необходимый для показа в текущем регионе (в рублях).

\* Обязательный параметр

<!--
<tree ><tree-item required="yes"><tree-itemname >data</tree-itemname><tree-itemdesc > Объект с параметрами. </tree-itemdesc><tree-item required="yes" id="type-patch"><tree-itemname >type</tree-itemname><tree-itemdesc > Тип ресурса. </tree-itemdesc></tree-item><tree-item required="yes"><tree-itemname >attributes</tree-itemname><tree-itemdesc > Параметры объекта. 

{% note alert %}

Допустимые значения зависят от ресурса, к которому относится объект, и перечислены в параметре `editable_fields` операции [GET/{resource-id}/{object-id}](https://yandex.com/dev/partner-objects/doc/ru/reference/get-resource-id-object-id.md). Ниже, для примера, приведена часть параметров.

{% endnote %}

</tree-itemdesc><tree-item ><tree-itemname >brands</tree-itemname><tree-itemdesc > Бренды, которые необходимо установить на текущем объекте. </tree-itemdesc><tree-item ><tree-itemname >bid</tree-itemname><tree-itemdesc > Минимальная ставка, необходимая для показа бренда (в рублях). </tree-itemdesc></tree-item><tree-item ><tree-itemname >blocked</tree-itemname><tree-itemdesc > Бренд заблокирован (`true` или `false`). </tree-itemdesc></tree-item><tree-item ><tree-itemname >cpm</tree-itemname><tree-itemdesc > Минимальный CPM, необходимый для показа бренда (в рублях). </tree-itemdesc></tree-item></tree-item><tree-item ><tree-itemname >client_id</tree-itemname><tree-itemdesc > Идентификатор клиента. </tree-itemdesc></tree-item><tree-item ><tree-itemname >email</tree-itemname><tree-itemdesc > Электронная почта клиента. </tree-itemdesc></tree-item><tree-item ><tree-itemname >excluded_domains</tree-itemname><tree-itemdesc > Домены, которые необходимо исключить. </tree-itemdesc></tree-item><tree-item ><tree-itemname >excluded_phones</tree-itemname><tree-itemdesc > Телефоны, которые необходимо исключить. </tree-itemdesc></tree-item><tree-item id="geo"><tree-itemname >geo</tree-itemname><tree-itemdesc > Региональные таргетинги, которые необходимо установить на текущем объекте. </tree-itemdesc><tree-item ><tree-itemname >id</tree-itemname><tree-itemdesc id="geo-id"> Идентификатор региона. Узнать регион можно с помощью операции [GET/{resource-id}](https://yandex.com/dev/partner-objects/doc/ru/reference/get-resource-id.md). </tree-itemdesc></tree-item><tree-item ><tree-itemname >cpm</tree-itemname><tree-itemdesc > Минимальный CPM, необходимый для показа в текущем регионе (в рублях). </tree-itemdesc></tree-item></tree-item></tree-item></tree-item></tree>
-->

Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.


## Формат ответа {#output-structure}

## JSON

```json
{
  "data":
  {
      "relationships": {
        "{string}": {
          "links": {
            "related": "{string}",
            "self": "{string}"
          }
        },
        ...
      },
      "id": "{string}",
      "type": "{string}",
      "attributes": {
      },
      "links": {
        "self": "{string}"
      }
  },
  "links": {
    "first": "{string}",
    "next": "{string}",
    "prev": "{string}",
    "self": "{string}",
    "last": "{string}"
  }
}        
```

## Параметры ответа {#spec-output}

- **data** Информация о созданном объекте.

  - **relationships** Связанные ресурсы и объекты.

    - **links** Ссылки на объекты, связанные с текущим объектом.

      - **related** Ссылка на список связанных объектов с параметрами.

      - **self** Ссылка на список связанных объектов.

  - **id** Идентификатор объекта.

  - **attributes** Массив параметров объекта. Список параметров зависит от типа ресурса. Ниже, для примера, приведена часть параметров.

    - **actions** Действия, допустимые для текущего объекта.

    - **brands** Бренды, установленные на текущем объекте.

      - **bid** Минимальная ставка, необходимая для показа бренда (в рублях).

      - **blocked** Бренд заблокирован (`true` или `false`).

    - **client_id** Идентификатор клиента.

    - **editable_fields** Параметры текущего объекта, которые можно редактировать.

    - **email** Электронная почта клиента.

    - **excluded_domains** Исключенные домены.

    - **excluded_phones** Исключенные телефоны.

    - **geo** Региональные таргетинги, установленные на текущем объекте.

      - **id** Идентификатор региона. Узнать регион можно с помощью операции [GET/{resource-id}](https://yandex.com/dev/partner-objects/doc/ru/reference/get-resource-id.md).

      - **cpm** Минимальный CPM, необходимый для показа в текущем регионе (в рублях).

    - **lang** Язык интерфейса.

    - **lastname** Фамилия клиента.

    - **level** Уровень вложенности.

    - **login** Логин пользователя.

    - **midname** Отчество пользователя.

    - **multistate** Текущий статус объекта.

    - **multistate_name** Текстовое описание статуса объекта.

    - **name** Имя объекта.

    - **page_id** Идентификатор площадки.

    - **parent_id** Идентификатор родительского объекта.

    - **regularity** Порядок сортировки в интерфейсе.

    - **roles** Роли пользователя.

    - **status** Статус объекта. Допустимые значения:

      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- **sync** — синхронизирован;

      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- **pending** — отправляется.

  - **links** Ссылки, связанные с объектом.

    - **self** Ссылка на текущий объект.


<!--
<tree ><tree-item ><tree-itemname >data</tree-itemname><tree-itemdesc >Информация о созданном объекте.</tree-itemdesc><tree-item id="relationships"><tree-itemname >relationships</tree-itemname><tree-itemdesc > Связанные ресурсы и объекты. </tree-itemdesc><tree-item ><tree-itemname >links</tree-itemname><tree-itemdesc > Ссылки на объекты, связанные с текущим объектом. </tree-itemdesc><tree-item ><tree-itemname >related</tree-itemname><tree-itemdesc > Ссылка на список связанных объектов с параметрами. </tree-itemdesc></tree-item><tree-item ><tree-itemname >self</tree-itemname><tree-itemdesc > Ссылка на список связанных объектов. </tree-itemdesc></tree-item></tree-item></tree-item><tree-item id="id-data"><tree-itemname >id</tree-itemname><tree-itemdesc > Идентификатор объекта. </tree-itemdesc></tree-item><tree-item id="attributes-def"><tree-itemname >attributes</tree-itemname><tree-itemdesc > Массив параметров объекта. Список параметров зависит от типа ресурса. Ниже, для примера, приведена часть параметров.</tree-itemdesc><tree-item ><tree-itemname >actions</tree-itemname><tree-itemdesc > Действия, допустимые для текущего объекта. </tree-itemdesc></tree-item><tree-item ><tree-itemname >brands</tree-itemname><tree-itemdesc > Бренды, установленные на текущем объекте. </tree-itemdesc><tree-item ><tree-itemname >bid</tree-itemname><tree-itemdesc > Минимальная ставка, необходимая для показа бренда (в рублях). </tree-itemdesc></tree-item><tree-item ><tree-itemname >blocked</tree-itemname><tree-itemdesc > Бренд заблокирован (`true` или `false`). </tree-itemdesc></tree-item></tree-item><tree-item ><tree-itemname >client_id</tree-itemname><tree-itemdesc > Идентификатор клиента. </tree-itemdesc></tree-item><tree-item ><tree-itemname >editable_fields</tree-itemname><tree-itemdesc > Параметры текущего объекта, которые можно редактировать. </tree-itemdesc></tree-item><tree-item ><tree-itemname >email</tree-itemname><tree-itemdesc > Электронная почта клиента. </tree-itemdesc></tree-item><tree-item ><tree-itemname >excluded_domains</tree-itemname><tree-itemdesc > Исключенные домены. </tree-itemdesc></tree-item><tree-item ><tree-itemname >excluded_phones</tree-itemname><tree-itemdesc > Исключенные телефоны. </tree-itemdesc></tree-item><tree-item ><tree-itemname >geo</tree-itemname><tree-itemdesc > Региональные таргетинги, установленные на текущем объекте. </tree-itemdesc><tree-item ><tree-itemname >id</tree-itemname><tree-itemdesc id="geo-id"> Идентификатор региона. Узнать регион можно с помощью операции [GET/{resource-id}](https://yandex.com/dev/partner-objects/doc/ru/reference/get-resource-id.md). </tree-itemdesc></tree-item><tree-item ><tree-itemname >cpm</tree-itemname><tree-itemdesc > Минимальный CPM, необходимый для показа в текущем регионе (в рублях). </tree-itemdesc></tree-item></tree-item><tree-item ><tree-itemname >lang</tree-itemname><tree-itemdesc > Язык интерфейса. </tree-itemdesc></tree-item><tree-item ><tree-itemname >lastname</tree-itemname><tree-itemdesc > Фамилия клиента. </tree-itemdesc></tree-item><tree-item ><tree-itemname >level</tree-itemname><tree-itemdesc > Уровень вложенности. </tree-itemdesc></tree-item><tree-item ><tree-itemname >login</tree-itemname><tree-itemdesc > Логин пользователя. </tree-itemdesc></tree-item><tree-item ><tree-itemname >midname</tree-itemname><tree-itemdesc > Отчество пользователя. </tree-itemdesc></tree-item><tree-item ><tree-itemname >multistate</tree-itemname><tree-itemdesc > Текущий статус объекта. </tree-itemdesc></tree-item><tree-item ><tree-itemname >multistate_name</tree-itemname><tree-itemdesc > Текстовое описание статуса объекта. </tree-itemdesc></tree-item><tree-item ><tree-itemname >name</tree-itemname><tree-itemdesc > Имя объекта. </tree-itemdesc></tree-item><tree-item ><tree-itemname >page_id</tree-itemname><tree-itemdesc > Идентификатор площадки. </tree-itemdesc></tree-item><tree-item ><tree-itemname >parent_id</tree-itemname><tree-itemdesc > Идентификатор родительского объекта. </tree-itemdesc></tree-item><tree-item ><tree-itemname >regularity</tree-itemname><tree-itemdesc > Порядок сортировки в интерфейсе. </tree-itemdesc></tree-item><tree-item ><tree-itemname >roles</tree-itemname><tree-itemdesc > Роли пользователя. </tree-itemdesc></tree-item><tree-item ><tree-itemname >status</tree-itemname><tree-itemdesc > Статус объекта. Допустимые значения: 
- sync — синхронизирован;
- pending — отправляется.
</tree-itemdesc></tree-item></tree-item><tree-item id="links-self"><tree-itemname >links</tree-itemname><tree-itemdesc id="links"> Ссылки, связанные с объектом. </tree-itemdesc><tree-item ><tree-itemname >self</tree-itemname><tree-itemdesc id="self"> Ссылка на текущий объект. </tree-itemdesc></tree-item></tree-item></tree-item></tree>
-->


## Пример для JSON {#example-JSON}

`$PI_TOKEN` должен содержать значение токена для API партнерского интерфейса. Например, значение может начинаться с «a7b8e0-». Также задайте свое значение для параметра `page_id`.


<!--&quot;block_type&quot;: &quot;banner&quot;,  (после "site_version": "mobile",)-->
> Запрос:
> 
> ```
> curl -v -H "Accept: application/vnd.api+json" \
> -H "Content-Type: application/vnd.api+json" \
> -H "Authorization: token $PI_TOKEN" \
> -X POST \
> --data \
>   '{
>     "data":
>     {
>       "type":"context_on_site_rtb",
>       "attributes":
>       {
>         "caption":"API-created block",
>         "page_id": "636326",
>         "site_version": "mobile",
>         
>         "design_templates":[
>           {
>             "caption":"Media design",
>             "type":"media",
>             "design_settings":
>             {
>               "filterSizes":false,
>               "horizontalAlign":true
>             }
>           },
>           {
>             "caption":"Standard design",
>             "type":"tga",
>             "filter_tags":["adaptive","vertical"],
>             "is_custom_format_direct": false, 
>             "design_settings":
>             {
>               "name":"adaptive0418",
>               "limit":1
>             }                    
>           }
>         ],
>         "dsp_blocks":["300x300","300x500","300x600","336x280","100%x250"],
>         "blind":0,
>         "strategy":1
>       }
>     }
>   }' \
> 'https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb' | json_pp
> ```
> 
> Ответ:
> 
> ```json
> HTTP/1.1 201 Created
> Content-Length: 683
> Content-Type: application/vnd.api+json
> Date: Fri, 13 Nov 2020 11:32:18 GMT
> Location: https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-636326-3
> Strict-Transport-Security: max-age=31536000; includeSubDomains
> X-Content-Type-Options: nosniff
> 
> 
> {
>    "data" : {
>       "attributes" : {},
>       "id" : "R-A-636326-4",
>       "links" : {
>          "self" : "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-636326-4"
>       },
>       "relationships" : {
>          "context_on_site_campaign" : {
>             "links" : {
>                "related" : "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-636326-4/context_on_site_campaign",
>                "self" : "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-636326-4/relationships/context_on_site_campaign"
>             }
>          },
>          "pages" : {
>             "links" : {
>                "related" : "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-636326-4/pages",
>                "self" : "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-636326-4/relationships/pages"
>             }
>          }
>       },
>       "type" : "context_on_site_rtb"
>    }
> }
> ```


[*Обязательный_параметр]: Обязательный параметр