Remover etiqueta personalizada de uma empresa

PATCH

/documents/labels/{companyId}/remove/{label}

Remove uma etiqueta personalizada do conjunto de etiquetas da empresa. Informe no path o nome exato da etiqueta, codificado para URL quando tiver espaços ou acentos. Só etiquetas personalizadas (custom igual a true) são removidas: para uma etiqueta pré-definida, a resposta é 200 com a mesma mensagem de sucesso, mas a etiqueta continua no conjunto. As pastas e os arquivos que usam a etiqueta não são alterados. Nome que não existe no conjunto devolve 400 (Essa etiqueta não existe!). Empresa inexistente, ou sem conjunto de etiquetas, devolve 400. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200

application/json

Etiqueta removida

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Etiqueta não removida

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/documents/labels//remove/' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "message": "Label deletada com sucesso."
}

Modificado em 2026-10-13 09:47:06

Página anterior

Adicionar etiqueta personalizada a uma empresa

Próxima página

Solicitar redefinição de senha