# Пакетная установка тегов профилей браузера

Заменяет теги выбранных ресурсов. Требуются право управления тегами и доступ к целям. Имена сравниваются точно в пределах команды: отсутствующие теги создаются, существующие используются повторно с обновлением цвета. Изменение цвета затрагивает и другие ресурсы с этим тегом. Повторяющиеся имена в одном запросе запрещены. Пустой массив `tags` удаляет только привязки, сохраняя определения тегов и группы. Операция синхронная, `data` равен null. После тайм-аута проверьте цели и `/api/envtag/all` перед повтором; ключа идемпотентности нет.
Задокументированные бизнес-ошибки: `15003`, `15004`, `19039`, `19173`, `19193`. Значения кодов см. в [Error Codes](/ru/api-reference/getting-started/error-codes). Любая операция может дополнительно вернуть общие коды.

Endpoint: POST /api/env/setTags/batch
Version: 2026-09-05

## Request fields (application/json):

  - `envIds` (array)
    ID профилей. Укажите непустой `envIds` или `uniqueIds`; непустой `envIds` имеет приоритет. Действуют существующие правила пакетного выбора и проверки прав.

  - `uniqueIds` (array)
    Порядковые номера профилей, используемые при пустом или отсутствующем envIds.

  - `tags` (array, required)
    Теги для замены всех текущих привязок. Пустой массив удаляет привязки, но не определения тегов.

  - `tags.tagName` (string, required)
    Имя тега с точным сопоставлением внутри команды. Повторы имен в одном запросе отклоняются.

  - `tags.tagColor` (any)
    Цвет тега. При отсутствии или пустом значении используется red; только названия цветов, без шестнадцатеричных значений.

## Request examples:

  - `replace` (unknown)

  - `clear` (unknown)

  - `bySerialNumber` (unknown)

## Response 200:

  - `200` (unknown)
    Успешно. Привязки тегов обновлены синхронно; data равен null.

## Response 200 fields (application/json):

  - `code` (integer)
    Example: 0

  - `msg` (string | null)

  - `requestId` (string)

  - `data` (null)

