Перенести задачу в другую очередь с помощью запроса к API

Запрос позволяет переместить задачу в другую очередь.

POST

https://api.tracker.yandex.net/v3/issues/<id_задачи>/_move?queue=<ключ_очереди>

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

Если переносимая задача имеет тип и статус, которые не существуют в новой очереди, перенос не будет выполнен. Чтобы при переносе сбросить статус задачи в начальное значение, используйте параметр InitialStatus.

По умолчанию при переносе очищаются значения компонентов, версий и проектов задачи. Если в новой очереди настроены аналогичные значения для этих полей, для переноса компонентов, версий и проектов используйте параметр MoveAllFields.

Если в задаче установлены значения локальных полей, при переносе в другую очередь они будут удалены.

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

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

Для переноса задачи используйте HTTP-запрос с методом POST:

POST /v3/issues/<id_задачи>/_move?queue=<ключ_очереди>
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки
  • Host: адрес узла, предоставляющего API.

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth <OAuth-токен> при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer <IAM-токен> при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Cloud Organization. Читать подробнее

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • Используйте заголовок X-Org-ID, если к Трекеру привязана организация Яндекс 360 для бизнеса.

    • Используйте заголовок X-Cloud-Org-ID, если к Трекеру привязана организация Yandex Cloud Organization.

    Чтобы узнать идентификатор организации, перейдите на страницу АдминистрированиеОрганизации и скопируйте значение поля идентификатор.

Ресурс
Параметр Описание Тип данных
<id_задачи> Идентификатор или ключ текущей задачи. Строка
Параметры запроса

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

Параметр Описание Тип данных
<ключ_очереди> Ключ очереди, в которую необходимо перенести задачу. Строка

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

Параметр Описание Тип данных
notify Признак уведомления об изменении задачи:
  • true – (по умолчанию) пользователи, указанные в полях задачи, получат уведомления;
  • false – пользователи не получат уведомления.
Логический
notifyAuthor Признак уведомления автора задачи:
  • true – автор получит уведомление;
  • false (по умолчанию) – автор не получит уведомление.
Логический
moveAllFields Перенос версий, компонентов и проектов задачи в новую очередь:
  • true – перенести, если в новой очереди существуют соответствующие версии, компоненты, проекты;
  • false (по умолчанию) – очистить версии, компоненты, проекты.
Логический
initialStatus Сброс статуса задачи в начальное значение. Статус необходимо сбросить, если задача переносится в очередь с другим рабочим процессом:
  • true – статус будет сброшен;
  • false (по умолчанию) – статус останется без изменений.
Логический
expand Дополнительные поля, которые будут включены в ответ:
  • attachments – вложения;
  • comments – комментарии;
  • workflow – рабочий процесс задачи;
  • transitions – переходы по жизненному циклу.
Строка
Параметры тела запроса

Тело запроса можно использовать в случае, если требуется изменить параметры переносимой задачи. Тело имеет такой же формат, как и при редактировании задачи.

Пример: Перенести задачу

  • Используется HTTP-метод POST.
  • Задача «TEST-1» перемещается в очередь «NEW».
POST https://api.tracker.yandex.net/v3/issues/TEST-1/_move?queue=NEW

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

В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK.

Тело ответа содержит результаты в формате JSON.

{
    "self": "https://api.tracker.yandex.net/v3/issues/NEW-1",
    "id": "1a********",
    "key": "NEW-1",
    "version": 2,
    "aliases": [
        "TEST-1"
    ],
    "previousQueue": {
        "self": "https://api.tracker.yandex.net/v3/queues/TEST",
        "id": "3",
        "key": "TEST",
        "display": "TEST"
    },
    "description": "My description",
    "type": {
        "self": "https://api.tracker.yandex.net/v3/issuetypes/2",
        "id": "2",
        "key": "task",
        "display": "Задача"
    },
    "createdAt": "2020-09-04T14:18:56.776+0000",
    "updatedAt": "2020-11-12T12:38:19.040+0000",
    "lastCommentUpdatedAt": "2020-10-18T13:33:44.291+0000",
    "summary": "Тест",
    "updatedBy": {
        "self": "https://api.tracker.yandex.net/v3/users/11********",
        "id": "11********",
        "display": "Имя Фамилия"
    },
    "priority": {
        "self": "https://api.tracker.yandex.net/v3/priorities/3",
        "id": "3",
        "key": "normal",
        "display": "Средний"
    },
    "followers": [
        {
            "self": "https://api.tracker.yandex.net/v3/users/11********",
            "id": "11********",
            "display": "Имя Фамилия"
        }
    ],
    "createdBy": {
        "self": "https://api.tracker.yandex.net/v3/users/11********",
        "id": "11********",
        "display": "Имя Фамилия"
    },
    "assignee": {
        "self": "https://api.tracker.yandex.net/v3/users/11********",
        "id": "11********",
        "display": "Имя Фамилия"
    },
    "queue": {
        "self": "https://api.tracker.yandex.net/v3/queues/NEW",
        "id": "5",
        "key": "NEW",
        "display": "My queue"
    },
    "status": {
        "self": "https://api.tracker.yandex.net/v3/statuses/1",
        "id": "1",
        "key": "open",
        "display": "Открыт"
    },
    "previousStatus": {
        "self": "https://api.tracker.yandex.net/v3/statuses/3",
        "id": "3",
        "key": "resolved",
        "display": "Решен"
    },
    "favorite": false
}
Параметры ответа
Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о задаче. Строка
id Идентификатор задачи. Строка
key Ключ задачи. Строка
version Версия задачи. Каждое изменение параметров задачи увеличивает номер версии.
Редактирование задачи будет заблокировано, если версия достигнет предельного значения: для роботов 10100, для пользователей 11100.
Число
aliases Массив с информацией об альтернативных ключах задачи. Массив строк
previousQueue Объект с информацией о предыдущей очереди задачи. Объект
description Описание задачи. Строка
type Объект с информацией о типе задачи. Объект
createdAt Дата и время создания задачи. Строка
updatedAt Дата и время обновления задачи. Строка
lastCommentUpdatedAt Дата и время последнего добавленного комментария. Строка
summary Название задачи. Строка
updatedBy Объект с информацией о последнем пользователе, изменявшим задачу. Объект
priority Объект с информацией о приоритете. Объект
followers Массив объектов с информацией о наблюдателях задачи. Массив строк
createdBy Объект с информацией о создателе задачи. Объект
assignee Объект с информацией об исполнителе задачи. Объект
queue Объект с информацией об очереди задачи. Объект
status Объект с информацией о статусе задачи. Объект
previousStatus Объект с информацией о предыдущем статусе задачи. Объект
favorite Признак избранной задачи:
  • true – уведомления отключены;
  • false – уведомления включены.
Логический

Поля объекта previousQueue

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию об очереди. Строка
id Идентификатор очереди. Строка
key Ключ очереди. Строка
display Отображаемое название очереди. Строка

Поля объекта type

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о типе задаче. Строка
id Идентификатор типа задачи. Строка
key Ключ типа задачи. Строка
display Отображаемое название типа задачи. Строка

Поля объекта updatedBy

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о пользователе. Строка
id Идентификатор пользователя. Строка
display Отображаемое имя пользователя. Строка
passportUid Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. Число
cloudUid Уникальный идентификатор пользователя в Yandex Cloud Organization. Строка

Поля объекта priority

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о приоритете. Строка
id Идентификатор приоритета. Строка
key Ключ приоритета. Строка
display Отображаемое название приоритета. Строка

Поля массива объектов followers

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о пользователе. Строка
id Идентификатор пользователя. Строка
display Отображаемое имя пользователя. Строка
passportUid Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. Число
cloudUid Уникальный идентификатор пользователя в Yandex Cloud Organization. Строка

Поля объекта createdBy

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о пользователе. Строка
id Идентификатор пользователя. Строка
display Отображаемое имя пользователя. Строка
passportUid Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. Число
cloudUid Уникальный идентификатор пользователя в Yandex Cloud Organization. Строка

Поля объекта assignee

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о пользователе. Строка
id Идентификатор пользователя. Строка
display Отображаемое имя пользователя. Строка
passportUid Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. Число
cloudUid Уникальный идентификатор пользователя в Yandex Cloud Organization. Строка

Поля объекта queue

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию об очереди. Строка
id Идентификатор очереди. Строка
key Ключ очереди. Строка
display Отображаемое название очереди. Строка

Поля объекта status

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о статусе. Строка
id Идентификатор статуса. Строка
key Ключ статуса. Строка
display Отображаемое название статуса. Строка

Поля объекта previousStatus

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о статусе. Строка
id Идентификатор статуса. Строка
key Ключ статуса. Строка
display Отображаемое название статуса. Строка

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

401
Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.
403
У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
404
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
423
Редактирование объекта заблокировано. Возможно, превышено допустимое значение параметра version — количество обновлений объекта. Максимальное значение версии составляет 10100 для роботов и 11100 для пользователей.