Перенести задачу в другую очередь

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

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

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

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

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

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

POST /v2/issues/<issue-id>/_move?queue=<queue-id>

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

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


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


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

Тело запроса

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

Перенос задачи:

Используется HTTP-метод POST.
Задача «TEST-1» перемещается в очередь «NEW».

POST /v2/issues/TEST-1/_move?queue=NEW
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>

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

{
    "self": "https://api.tracker.yandex.net/v2/issues/NEW-1",
    "id": "1a2345678b",
    "key": "NEW-1",
    "version": 2,
    "aliases": [
        "TEST-1"
    ],
    "previousQueue": {
        "self": "https://api.tracker.yandex.net/v2/queues/TEST",
        "id": "3",
        "key": "TEST",
        "display": "TEST"
    },
    "description": "<описание задачи>",
    "type": {
        "self": "https://api.tracker.yandex.net/v2/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/v2/users/1234567890",
        "id": "1234567890",
        "display": "Имя Фамилия"
    },
    "priority": {
        "self": "https://api.tracker.yandex.net/v2/priorities/3",
        "id": "3",
        "key": "normal",
        "display": "Средний"
    },
    "followers": [
        {
            "self": "https://api.tracker.yandex.net/v2/users/1234567890",
            "id": "1234567890",
            "display": "Имя Фамилия"
        }
    ],
    "createdBy": {
        "self": "https://api.tracker.yandex.net/v2/users/1234567890",
        "id": "1234567890",
        "display": "Имя Фамилия"
    },
    "assignee": {
        "self": "https://api.tracker.yandex.net/v2/users/1234567890",
        "id": "1234567890",
        "display": "Имя Фамилия"
    },
    "queue": {
        "self": "https://api.tracker.yandex.net/v2/queues/NEW",
        "id": "5",
        "key": "NEW",
        "display": "Очередь"
    },
    "status": {
        "self": "https://api.tracker.yandex.net/v2/statuses/8",
        "id": "1",
        "key": "open",
        "display": "Открыт"
    },
    "previousStatus": {
        "self": "https://api.tracker.yandex.net/v2/statuses/1",
        "id": "1",
        "key": "open",
        "display": "Открыт"
    },
    "favorite": false
}

Параметры ответа


Параметр	Описание	Тип данных
`self`	Адрес ресурса API, который содержит информацию о задаче.	Строка.
`id`	Идентификатор задачи.	Строка.
`key`	Ключ задачи.	Строка.
`version`	Версия задачи. Каждое изменение параметров задачи увеличивает номер версии.	Число.
`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`	Отображаемое имя пользователя.	Строка.
Поля объекта `priority`
`self`	Адрес ресурса API, который содержит информацию о приоритете.	Строка.
`id`	Идентификатор типа приоритета.	Число.
`key`	Ключ типа приоритета.	Строка.
`display`	Отображаемое название типа приоритета.	Строка.
Поля массива объектов `followers`
`self`	Адрес ресурса API, который содержит информацию о пользователе.	Строка.
`id`	Идентификатор пользователя.	Число.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `createdBy`
`self`	Адрес ресурса API, который содержит информацию о пользователе.	Строка.
`id`	Идентификатор пользователя.	Число.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `assignee`
`self`	Адрес ресурса API, который содержит информацию о пользователе.	Строка.
`id`	Идентификатор пользователя.	Число.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `queue`
`self`	Адрес ресурса API, который содержит информацию об очереди.	Строка.
`id`	Идентификатор очереди.	Число.
`key`	Ключ очереди.	Строка.
`display`	Отображаемое название очереди.	Строка.
Поля объекта `status`
`self`	Адрес ресурса API, который содержит информацию о статусе.	Строка.
`id`	Идентификатор статуса.	Число.
`key`	Ключ типа статуса.	Строка.
`display`	Отображаемое название типа статуса.	Строка.
Поля объекта `previousStatus`
`self`	Адрес ресурса API, который содержит информацию о статусе.	Строка.
`id`	Идентификатор статуса.	Число.
`key`	Ключ типа статуса.	Строка.
`display`	Отображаемое название типа статуса.	Строка.


Параметр	Описание	Тип данных
`self`	Адрес ресурса API, который содержит информацию о задаче.	Строка.
`id`	Идентификатор задачи.	Строка.
`key`	Ключ задачи.	Строка.
`version`	Версия задачи. Каждое изменение параметров задачи увеличивает номер версии.	Число.
`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`	Отображаемое имя пользователя.	Строка.
Поля объекта `priority`
`self`	Адрес ресурса API, который содержит информацию о приоритете.	Строка.
`id`	Идентификатор типа приоритета.	Число.
`key`	Ключ типа приоритета.	Строка.
`display`	Отображаемое название типа приоритета.	Строка.
Поля массива объектов `followers`
`self`	Адрес ресурса API, который содержит информацию о пользователе.	Строка.
`id`	Идентификатор пользователя.	Число.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `createdBy`
`self`	Адрес ресурса API, который содержит информацию о пользователе.	Строка.
`id`	Идентификатор пользователя.	Число.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `assignee`
`self`	Адрес ресурса API, который содержит информацию о пользователе.	Строка.
`id`	Идентификатор пользователя.	Число.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `queue`
`self`	Адрес ресурса API, который содержит информацию об очереди.	Строка.
`id`	Идентификатор очереди.	Число.
`key`	Ключ очереди.	Строка.
`display`	Отображаемое название очереди.	Строка.
Поля объекта `status`
`self`	Адрес ресурса API, который содержит информацию о статусе.	Строка.
`id`	Идентификатор статуса.	Число.
`key`	Ключ типа статуса.	Строка.
`display`	Отображаемое название типа статуса.	Строка.
Поля объекта `previousStatus`
`self`	Адрес ресурса API, который содержит информацию о статусе.	Строка.
`id`	Идентификатор статуса.	Число.
`key`	Ключ типа статуса.	Строка.
`display`	Отображаемое название типа статуса.	Строка.

Возможные коды ответа

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