---
title: "Atualizar conhecimento"
method: PUT
path: "/knowledges/{id}"
tags: ["Conhecimentos"]
---

# Atualizar conhecimento

`PUT /knowledges/{id}`

## Request

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

Atualiza um conhecimento cadastrado em sua organização.

Esta rota segue os mesmos critérios de visibilidade da rota de [exibir conhecimento](#get-/knowledges/-id-): só é possível atualizar conhecimentos visíveis para o usuário autenticado. Caso o conhecimento não seja visível, a resposta será `404`.

Todos os parâmetros são opcionais, mas ao menos um deve ser informado: os campos não enviados mantêm os valores atuais do conhecimento. Ao informar 'description', uma nova versão do conhecimento é criada com o conteúdo enviado.

## Path parameters

- `id` integer, required

## Request body

- object
  - `title` string: Título
  - `description` string: Descrição ou texto do conhecimento, em formato HTML. Ao informar este campo, uma nova versão do conhecimento é criada com a descrição enviada. Se não informado, a versão atual do conhecimento é mantida
  - `knowledge_folder_ids` integer[]: Lista contendo os IDs das pastas de conhecimentos que serão relacionadas ao conhecimento
  - `tags` string[]: Lista contendo as tags do conhecimento. Devem ser strings que não possuem vírgula em seu nome
  - `services_catalogs_item_ids` integer[]: Lista contendo os IDs dos itens de catálogos de serviço que serão relacionados ao conhecimento
  - `private` boolean: O conhecimento é privado? Se não informado, o valor atual do conhecimento é mantido
  - `technical_group_ids` integer[]: Lista contendo os IDs dos grupos de atendentes que terão permissão para acessar o conhecimento. Substitui os grupos de atendentes relacionados atualmente. Se não informado, os grupos atuais são mantidos, e para remover todos, informe uma lista vazia. Só pode ser informado caso o conhecimento seja (ou esteja sendo atualizado para) do tipo privado. Se informado em um conhecimento público, a requisição retorna erro. Ao tornar um conhecimento privado em público, os relacionamentos existentes são removidos, já que o conhecimento deixa de ter restrição de acesso
  - `client_ids` integer[]: Lista contendo os IDs dos clientes que terão permissão para acessar o conhecimento. Substitui os clientes relacionados atualmente. Se não informado, os clientes atuais são mantidos, e para remover todos, informe uma lista vazia. Só pode ser informado caso o conhecimento seja (ou esteja sendo atualizado para) do tipo privado. Se informado em um conhecimento público, a requisição retorna erro. Ao tornar um conhecimento privado em público, os relacionamentos existentes são removidos, já que o conhecimento deixa de ter restrição de acesso

## Response `200`

### **Conhecimento atualizado com sucesso**

- object
  - `id` integer, required: Identificador do conhecimento
  - `title` string, required: Título
  - `description` string, required: Descrição ou texto do conhecimento, em formato HTML
  - `tags` string[], required: Lista contendo as tags do conhecimento
  - `private` boolean, required: O conhecimento é privado?
  - `client_ids` integer[], required: Lista contendo os IDs dos clientes que tem permissão para acessar o conhecimento. Sempre vazia quando o conhecimento é público
  - `technical_group_ids` integer[], required: Lista contendo os IDs dos grupos de atendentes que tem permissão para acessar o conhecimento. Sempre vazia quando o conhecimento é público
  - `created_at` string, required: Data da criação do conhecimento
  - `updated_at` string, required: Data da última modificação do conhecimento

## Other responses

- `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`: ### **Conhecimento não encontrado**
- `422`: ### **Problemas com os parâmetros informados**

## Changes

- **2026-09-01** `48ba8b3429a9`: 1 info
  - endpoint added

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