> As etiquetas que a organização usa para classificar conversas. Referência gerada do contrato da API. # Etiquetas {/* Gerado por scripts/gerar-referencia.mjs a partir de openapi/openapi.json. Não edite: rode `pnpm referencia`. */} # Etiquetas As etiquetas que a organização usa para classificar conversas. | Operação | Endpoint | |---|---| | [Listar etiquetas](#listar-etiquetas) | `GET /tags` | ## Listar etiquetas Lista as etiquetas da organização, em ordem alfabética. Sem paginação: a lista é curta. Permissão exigida na chave: `configuracao:read`. ### Resposta 200 Uma lista de objetos [Tag](#objeto-tag) em `data`. ### Erros | Status | Quando | |---|---| | `401` | `unauthenticated`: Não autenticado. `invalid_credential`: Credencial inválida. | | `403` | `insufficient_scope`: Escopo insuficiente. | | `429` | `rate_limited`: Limite de requisições atingido. Tente de novo depois do tempo indicado em Retry-After. | | `500` | `internal_error`: Erro interno. Tente de novo; se persistir, fale com o suporte informando o X-Request-Id. | O corpo segue o formato de [Erros](/erros). ### Exemplo ```bash curl "https://app.conectaai.io/api/v1/tags" \ -H "Authorization: Bearer $CONECTAAI_API_KEY" ``` Resposta `200`: ```json { "data": [ { "id": "8f0c2a4e-1b7d-4c55-9a1e-3d2f6b7c8a90", "slug": "sem-conexao", "name": "Sem conexão", "description": null, "kind": "general", "created_at": "2026-11-09T14:32:05.120Z" } ] } ``` ## Objeto Tag Etiqueta que a organização usa para classificar conversas. | Campo | Tipo | Descrição | |---|---|---| | `id` | texto | Identificador da etiqueta. | | `slug` | texto | Chave da etiqueta. É o valor que aparece em `tags` da conversa. | | `name` | texto | Nome exibido. | | `description` | texto ou `null` | Descrição escrita pela equipe. | | `kind` | `general`, `resolution` | general: etiqueta comum. resolution: marca como a conversa foi resolvida. | | `created_at` | texto | Quando a etiqueta foi criada. Data e hora em ISO 8601, UTC. |