---
title: "Atualizar pasta de conhecimentos"
method: PUT
path: "/knowledge-folders/{id}"
tags: ["Conhecimentos"]
---

# Atualizar pasta de conhecimentos

`PUT /knowledge-folders/{id}`

## Request

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

Atualiza uma pasta de conhecimentos cadastrada em sua organização.

Todos os parâmetros são opcionais, mas ao menos um deve ser informado: os campos não enviados mantêm os valores atuais da pasta.

- Ao informar `tags`, a lista enviada **substitui** todas as tags atuais da pasta. Para remover todas as tags, informe uma lista vazia.

- Só é possível atualizar pastas da sua organização. Caso a pasta não exista ou pertença a outra organização, a resposta será `404`.

- Os campos `qty_knowledges` e `knowledges` retornados seguem os mesmos critérios da rota de [exibir pasta de conhecimentos](#get-/knowledge-folders/-id-) e não são alterados por esta rota.

## Path parameters

- `id` integer, required

## Request body

- object
  - `title` string: 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 `200`

### **Pasta de conhecimentos atualizada 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
- `404`: ### **Pasta de conhecimentos não encontrada**
- `422`: ### **Problemas com os parâmetros informados**

## Changes

- **2026-10-01** `8934e614279d`: 1 breaking, 1 warning
  - the response property `description` became nullable for the status `200`
  - the `title` request property's maxLength was set to `255`
- **2026-09-16** `787539bd156d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/knowledge-folders/:id/put.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)