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

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

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

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

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

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

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

Заголовки

• Host

  Адрес узла, предоставляющего API:

  https://api.tracker.yandex.net
  

• Authorization

  OAuth-токен в формате OAuth <значение токена>, например:

  OAuth 0c4181a7c2cf4521964a72ff57a34a07
  

• X-Org-ID

  Идентификатор организации.

Параметры запроса

Дополнительные параметры

Параметры тела запроса

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

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

• Используется HTTP-метод POST.

• Тип задач TEST-1, TEST-2, TEST-3 меняется на Ошибка.

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

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

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