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

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

Yandex.Cloud

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

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

Важно

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

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

Перед выполнением запроса получите доступ к 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 No Content. Тело ответа отсутствует.

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

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