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


# POST/{resource-id}/{object-id}/action/{action-name}

Совершает указанное действие с объектом.

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

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

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

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

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

{% endnote %}

||
|#

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


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

## JSON

```json
{
  "data": 
  {
    "relationships": {
      "{string}": {
        "links": {
          "related": "{string}",
          "self": "{string}"
        }
      }
    },
    "id": "{string}",
    "type": "{string}",
    "attributes": {}
  },
  "meta": {
    "fields": []
  },
  "links": {
    "self": "{string}"
  }
}    
```

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

- **data** Массив с информацией по указанному объекту.

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

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

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

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

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

  - **type** Тип ресурса.

  - **attributes** Параметры объекта.

- **meta** Объект содержит метаинформацию.

  - **fields** Параметры объекта.

- **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 ><tree-itemname >id</tree-itemname><tree-itemdesc > Идентификатор объекта. </tree-itemdesc></tree-item><tree-item ><tree-itemname >type</tree-itemname><tree-itemdesc > Тип рсурса. </tree-itemdesc></tree-item><tree-item ><tree-itemname >attributes</tree-itemname><tree-itemdesc > Параметры объекта. </tree-itemdesc></tree-item></tree-item><tree-item ><tree-itemname >meta</tree-itemname><tree-itemdesc > Объект содержит метаинформацию. </tree-itemdesc><tree-item ><tree-itemname >fields</tree-itemname><tree-itemdesc > Параметры объекта. </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>
-->


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

> Запрос:
> 
> ```
> curl -i -g -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: token 66.." -X POST 'https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-1056-1/action/duplicate'
> ```
> 
> Ответ:
> 
> ```json
> HTTP/1.1 200 OK
> Server: nginx/1.8.1
> Date: Wed, 18 Jan 2017 17:33:25 GMT
> Content-Type: application/vnd.api+json
> Content-Length: 757
> Connection: keep-alive
> 
> {
>   "data": 
>   {
>     "relationships": {
>       "context_on_site_campaign": {
>         "links": {
>           "related": "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-1056-2/context_on_site_campaign",
>           "self": "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-1056-2/relationships/context_on_site_campaign"
>         }
>       },
>       "pages": {
>         "links": {
>           "related": "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-1056-2/pages",
>           "self": "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-1056-2/relationships/pages"
>         }
>       }
>     },
>     "id": "R-A-1056-2",
>     "type": "context_on_site_rtb",
>     "attributes": {}
>   },
>   "meta": {
>     "fields": []
>   },
>   "links": {
>     "self": "https://jsonapi.partner2.yandex.com/v1/context_on_site_rtb/R-A-1056-2"
>   }
> }
>       
> ```