> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/api/kcs-api-conhecimento-listar-pastas-conhecimentos-via-api-no-tiflux.md).

# KCS - API Conhecimento - Listar Pastas Conhecimentos via API no TiFlux

## 📁 API Conhecimento - Listar Pastas Conhecimentos via API no TiFlux

🕒 Tempo aproximado para leitura: 00:01:30 min<br>

***

### ❓ Dúvida / Problema

É possível consultar e listar as pastas da Base de Conhecimento via integração (API v2) e quais regras de acesso, parâmetros ou filtros estão disponíveis nessa rota?<br>

***

### 🔎 Causa / Contexto

Desenvolvedores e administradores necessitam compreender o escopo técnico e o comportamento da API do TiFlux ao consultar a estrutura de pastas e os artigos vinculados a elas para integração com portais externos, intranets ou *chatbots*.<br>

***

### ✅ Solução / Especificação Técnica da API

Sim, a API v2 do TiFlux disponibiliza o *endpoint* `GET /knowledge-folders` para consultar e integrar as pastas de conhecimentos cadastradas na organização.<br>

#### 1. Regras de Visibilidade e Permissão

* Sem restrição (Acesso total): Requer a permissão de *"Gerenciar base de conhecimento"*.
* Acesso padrão (Sem permissão específica): Retorna as pastas com conhecimentos públicos e as pastas associadas ao grupo de atendentes do usuário autenticado.<br>

#### 2. Filtros e Recursos Suportados pela API

* Busca textual (`search`): Permite filtrar pastas por título, tags e primeiros caracteres da descrição.
* Paginação (`offset` e `limit`): Controle de páginas e limite de retorno (de 1 até 200 itens por requisição).
* Mapeamento de IDs (`knowledge_ids`): Traz a lista completa dos IDs de conhecimentos vinculados a cada pasta.<br>

#### 3. Documentação da Requisição

* Endpoint: `GET [`[`https://api.tiflux.com/api/v2/#get-/knowledge-folders`](https://api.tiflux.com/api/v2/#get-/knowledge-folders)`]`
* Autenticação: Header HTTP `Bearer Token`
* Documentação Completa: [Documentação da API v2 - Knowledge Folders](https://api.tiflux.com/api/v2/#get-/knowledge-folders)<br>

> 💡 Dica de Especialista / Nota Comercial: Esta funcionalidade permite integrar a Base de Conhecimento do TiFlux a portais corporativos, intranets, bots de atendimento (AI) ou sistemas externos, automatizando a exibição da árvore de conteúdos.<br>

***

### 🔍 Palavras-chave para busca

```
listar pastas conhecimento api tiflux,
endpoint knowledge folders api v2,
get knowledge folders tiflux,
integrar base de conhecimento api,
filtrar pastas conhecimento search,
knowledge_ids api tiflux,
qty_knowledges pastas conhecimento
```