Массовое редактирование сущностей

Запрос позволяет массово обновить сущности — проекты или портфели проектов.

Формат запросаФормат запроса

Перед выполнением запроса получите доступ к API.

Для пакетного изменения нескольких сущностей используйте HTTP-запрос с методом POST. Параметры запроса передаются в его теле в формате JSON.

POST /v2/entities/<тип_сущности>/bulkchange/_update
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
   "metaEntities":[ "<идентификатор_сущности_1>","<идентификатор_сущности_2>", ...], 
   "values":
   {
      "fields":
      {
         "<ключ_поля>":"<значение>",
         ...
      },
      "comment":"<комментарий>"
   }
}

Пример: Для нескольких проектов изменить статус, назначить наблюдателя и оставить комментарий

• Используется HTTP-метод POST.
• Статус проектов меняется на Есть риски.
• Назначается наблюдатель.
• В комментарии проекта добавляется новая запись.

POST /v2/entities/project/bulkchange/_update HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
   "metaEntities":[ "655f3be523db2132********","655f383923db2132********"], 
   "values":
   {
      "fields":
      {
         "entityStatus":"at_risk",
         "followers":"agent007",
      },
      "comment":"Проект в зоне риска"
   }
}

Формат ответаФормат ответа

{
   "id": "6560c6f59b0b1e76********",
   "self": "https://api.tracker.yandex.net/v2/bulkchange/6560c6f59b0b1e76********",
   "createdBy": { "self": "https://api.tracker.yandex.net/v2/users/11********", "id": "11********", "display": "Имя Фамилия", "cloudUid": "ajevuhegoggf********", "passportUid": 11******** },
   "createdAt": "2023-11-24T15:53:25.122+0000",
   "status": "CREATED",
   "statusText": "Операция массового редактирования задач создана.",
   "executionChunkPercent": 0,
   "executionIssuePercent": 0
}