# Definir etiquetas de perfis em lote

Substitui as etiquetas dos recursos selecionados. Exige permissão para gerenciar etiquetas e acesso aos destinos. Os nomes são comparados exatamente na equipe: etiquetas ausentes são criadas e as existentes são reutilizadas com a cor atualizada. A mudança de cor também afeta outros recursos com a mesma etiqueta. Nomes duplicados na mesma solicitação são rejeitados. Um array `tags` vazio remove apenas as associações, preservando definições e grupos. A operação é síncrona e `data` é null. Após um timeout, consulte os destinos e `/api/envtag/all` antes de tentar novamente; não há chave de idempotência.
Erros de negócio documentados: `15003`, `15004`, `19039`, `19173`, `19193`. Consulte [Error Codes](/pt/api-reference/getting-started/error-codes) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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

## Request fields (application/json):

  - `envIds` (array)
    IDs de perfis. Informe `envIds` ou `uniqueIds` não vazio; `envIds` não vazio tem prioridade. Aplicam-se as regras existentes de seleção em lote e permissões.

  - `uniqueIds` (array)
    Números de série dos perfis, usados quando envIds está vazio ou omitido.

  - `tags` (array, required)
    Etiquetas que substituem todas as associações atuais. Um array vazio remove as associações sem excluir as definições.

  - `tags.tagName` (string, required)
    Nome da etiqueta, comparado exatamente na equipe. Nomes duplicados na mesma solicitação são rejeitados.

  - `tags.tagColor` (any)
    Cor da etiqueta. Se omitida ou em branco, usa red; apenas nomes de cores, sem valores hexadecimais.

## Request examples:

  - `replace` (unknown)

  - `clear` (unknown)

  - `bySerialNumber` (unknown)

## Response 200:

  - `200` (unknown)
    Sucesso. As associações foram atualizadas de forma síncrona; data é null.

## Response 200 fields (application/json):

  - `code` (integer)
    Example: 0

  - `msg` (string | null)

  - `requestId` (string)

  - `data` (null)

