---
title: "Criar pasta de conhecimentos"
method: POST
path: "/knowledge-folders"
tags: ["Conhecimentos"]
---

# Criar pasta de conhecimentos

`POST /knowledge-folders`

## Request

- Base URL: `https://api.tiflux.com/api/v2`
- URL: `https://api.tiflux.com/api/v2/knowledge-folders`
- Auth: HTTP bearer

Cria uma pasta de conhecimentos na sua organização.

- A pasta é criada sem conhecimentos vinculados, por isso `qty_knowledges` retorna `0` e `knowledges` retorna uma lista vazia.

## Request body

- object
  - `title` string, required: Título da pasta de conhecimentos. Não pode ser vazio
  - `description` string: Descrição da pasta de conhecimentos
  - `icon` string: Ícone da pasta de conhecimentos. Deve ser um único emoji
  - `tags` string[]: Lista contendo as tags da pasta de conhecimentos. Cada tag não pode ser vazia nem conter vírgula em seu nome e, somadas, elas devem ter no máximo 255 caracteres, considerando a vírgula que separa uma da outra. Tags repetidas são descartadas e os espaços em branco no início e no fim de cada uma são removidos

## Response `201`

### **Pasta de conhecimentos criada com sucesso**

- object
  - `id` integer, required: Identificador da pasta de conhecimentos
  - `title` string, required: Título
  - `description` string, nullable, required: Descrição da pasta de conhecimentos
  - `icon` string, nullable, required: Ícone da pasta de conhecimentos
  - `tags` string[], required: Lista contendo as tags da pasta de conhecimentos
  - `qty_knowledges` integer, required: Quantidade de conhecimentos não arquivados que estão dentro dessa pasta
  - `knowledges` object[], required: Lista contendo os conhecimentos não arquivados que estão dentro dessa pasta, ordenados pelo título
    - `id` integer, required: Identificador do conhecimento
    - `title` string, required: Título do conhecimento

## Other responses

- `400`: ### **Não informou um body pra requisição**
- `401`: ### **Problemas com o token de autenticação**
- `403`: ### **Problemas com permissão** Essa resposta significa que o seu grupo de permissões não possui a permissão necessária para acessar essa rota
- `422`: ### **Problemas com os parâmetros informados**

## Changes

- **2026-10-01** `8934e614279d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/knowledge-folders/post.md)

---

[API](https://skmtc.dev/tiflux/apis/tiflux-official-api.md) - [All operations](https://skmtc.dev/tiflux/apis/tiflux-official-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiflux/apis/tiflux-official-api/revisions/2936ac99a76d?raw)