Подключиться
Yandex Tracker

Удалить тег из очереди

Статья создана

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

Важно

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

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

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

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

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

{
    "tag": "<имя тега>"
}
Заголовки

  • Host

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

    https://api.tracker.yandex.net

  • Authorization

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

    OAuth 0c4181a7c2cf4521964a72ff57a34a07

  • X-Org-ID

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

Ресурс
Параметр Описание Тип данных
<queue-id> Идентификатор или ключ очереди. Ключ очереди чувствителен к регистру символов. Строка или число
Параметры тела запроса

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

Параметр Значение Тип данных
tag Имя тега Строка

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

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

Тело ответа отсутствует.

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

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