TItiflux
Conhecimentos

Atualizar conhecimento

Changed on

Atualiza um conhecimento cadastrado em sua organização.

Esta rota segue os mesmos critérios de visibilidade da rota de exibir conhecimento: 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.

put/knowledges/{id}

Request

  • Base URL
    https://api.tiflux.com/api/v2
  • Auth
    HTTP bearer

Path parameters

idinteger required

ID do conhecimento

Request body

titlestring

Título

descriptionstring

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_idsinteger[]

Lista contendo os IDs das pastas de conhecimentos que serão relacionadas ao conhecimento

tagsstring[]

Lista contendo as tags do conhecimento. Devem ser strings que não possuem vírgula em seu nome

services_catalogs_item_idsinteger[]

Lista contendo os IDs dos itens de catálogos de serviço que serão relacionados ao conhecimento

privateboolean

O conhecimento é privado? Se não informado, o valor atual do conhecimento é mantido

technical_group_idsinteger[]

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_idsinteger[]

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

Conhecimento atualizado com sucesso

idinteger required

Identificador do conhecimento

titlestring required

Título

descriptionstring required

Descrição ou texto do conhecimento, em formato HTML

tagsstring[] required

Lista contendo as tags do conhecimento

privateboolean required

O conhecimento é privado?

client_idsinteger[] required

Lista contendo os IDs dos clientes que tem permissão para acessar o conhecimento. Sempre vazia quando o conhecimento é público

technical_group_idsinteger[] 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_atstring required

Data da criação do conhecimento

updated_atstring required

Data da última modificação do conhecimento

Changes