# Excluir etiquetas

Exclui uma ou mais etiquetas de perfil.
- **Pré-requisitos**: pelo menos um identificador precisa ser resolvido dentro da equipe; os que não são resolvidos são ignorados em silêncio.
- **Efeito**: exclui as etiquetas. A etiqueta desaparece de todos os perfis que a carregavam, e nenhum perfil é excluído. Este endpoint gerencia apenas etiquetas de perfil: as etiquetas de arquivo do Cloud Storage são gerenciadas separadamente.
- **Conclusão**: sincrônica. Uma chamada repetida informa que as etiquetas são inválidas, o que significa que a primeira teve sucesso.

Erros de negócio documentados: `19105`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Endpoint: POST /api/envtag/delete
Version: 2026-09-05

## Request fields (application/json):

  - `ids` (array, required)
    ID único da tag a ser atualizada

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado retornado: 0: Normal. Outros códigos são exceções.

  - `msg` (string | null, required)
    Mensagem de erro

  - `data` (boolean, required)

  - `requestId` (string, required)
    ID da solicitação de operação

