Массовое редактирование задач

Запрос позволяет изменить параметры нескольких задач одновременно.

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

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

Чтобы изменить задачи, используйте HTTP-запрос с методом POST. Параметры запроса передаются в его теле в формате JSON.

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

{
  "issues": ["TEST-1", "TEST-2", "TEST-3"],
  "values": {
    "<параметр_1>": "<значение_параметра_1>",
    "<параметр_2>": "<значение_параметра_2>"
  }
}

Пример 1: Изменить задачи.

• Используется HTTP-метод POST.
• Тип задач «TEST-1», «TEST-2», «TEST-3» меняется на «Ошибка».

POST /v2/bulkchange/_update
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
 "issues": ["TEST-1","TEST-2","TEST-3"],
 "values": {
   "type": {"name": "Ошибка"}
 }
}

Пример 2: Изменить задачи, используя фильтр на языке запросов.

• Используется HTTP-метод POST.
• Для задач, в названии которых есть слово Test, приоритет меняется на Блокер и добавляется комментарий "Updated via API".

POST /v2/bulkchange/_update
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
 "issues": "Summary: Test"
 "values": {
   "comment": "Updated via API",
   "priority": {"key": "blocker"}
 }
}

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

{
    "id": "1ab23cd4e5678901********",
    "self": "https://api.tracker.yandex.net/v2/bulkchange/1ab23cd4e5678901********",
    "createdBy": {
        "self": "https://api.tracker.yandex.net/v2/users/12********",
        "id": "12********",
        "display": "Имя Фамилия"
    },
    "createdAt": "2020-12-15T11:52:53.665+0000",
    "status": "CREATED",
    "statusText": "Операция массового редактирования задач создана.",
    "executionChunkPercent": 0,
    "executionIssuePercent": 0
}