Выполнить переход в статус

Запрос позволяет перевести задачу в новый статус.

  1. Формат запроса
  2. Формат ответа

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

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

POST /v2/issues/<issue-id>/transitions/<transition-id>/_execute
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>

{
"<ключ1>":"<значение1>",
"<ключ2>":"<значение2>"
...
"comment":"<текст комментария>"
}
Ресурс
<issue-id>
Идентификатор или ключ задачи.
<transition-id>
Идентификатор перехода.
Заголовки
Host

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

https://api.tracker.yandex.net
Authorization

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

OAuth 0c4181a7c2cf4521964a72ff57a34a07
X-Org-ID

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

Тело запроса
Параметр Значение Тип данных
<ключ> Поле задачи, доступное для изменения при переходе. Список ключей: https://tracker.yandex.ru/admin/fields Зависит от типа параметра.
comment Комментарий к задаче. Строка.
Параметр Значение Тип данных
<ключ> Поле задачи, доступное для изменения при переходе. Список ключей: https://tracker.yandex.ru/admin/fields Зависит от типа параметра.
comment Комментарий к задаче. Строка.

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

В случае успешного выполнения запроса API возвращает ответ с кодом 200. Тело ответа содержит JSON-массив со списком переходов, доступных для задачи в новом статусе.

[ 
{
  "self" : "https://api.tracker.yandex.net/v2/issues/DESIGN-1/transitions/close",
  "id" : "close",
  "to" : {
  "self" : "https://api.tracker.yandex.net/v2/statuses/3",
    "id" : "3",
    "key" : "closed",
    "display" : "Closed"
  },
  "screen" : {
    "self" : "https://api.tracker.yandex.net/v2/screens/50c85b17e4b04b38ef31a522",
    "id" : "50c85b17e4b04b38ef31a522"
  }
 },
 ...
]
Параметры ответа
Параметр Описание Тип данных
self Ссылка на переход. Строка.
id Идентификатор перехода. Строка.
to Блок с информацией о статусе, в который можно перевести задачу. Объект.
screen Блок с информацией об экране перехода. Объект.
Поля объекта to
self Ссылка на статус. Строка.
id Идентификатор статуса. Строка.
key Ключ статуса. Строка.
display Отображаемое название статуса. Строка.
Поля объекта screen
self Ссылка на экран перехода. Строка.
id Идентификатор экрана перехода. Строка.
Параметр Описание Тип данных
self Ссылка на переход. Строка.
id Идентификатор перехода. Строка.
to Блок с информацией о статусе, в который можно перевести задачу. Объект.
screen Блок с информацией об экране перехода. Объект.
Поля объекта to
self Ссылка на статус. Строка.
id Идентификатор статуса. Строка.
key Ключ статуса. Строка.
display Отображаемое название статуса. Строка.
Поля объекта screen
self Ссылка на экран перехода. Строка.
id Идентификатор экрана перехода. Строка.