curl -X PUT "https://api.leavo.ai/backend/knowledge/9f1c2d34-5678-4abc-9def-0123456789ab" \
-H "Authorization: Bearer sua_chave_aqui" \
-H "Content-Type: application/json" \
-d '{
"name": "Política de trocas 2026",
"content": "Trocas em até 45 dias mediante apresentação da nota fiscal."
}'
const id = '9f1c2d34-5678-4abc-9def-0123456789ab';
const response = await fetch(`https://api.leavo.ai/backend/knowledge/${id}`, {
method: 'PUT',
headers: {
'Authorization': 'Bearer sua_chave_aqui',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Política de trocas 2026',
content: 'Trocas em até 45 dias mediante apresentação da nota fiscal.'
})
});
console.log(await response.json());
import requests
knowledge_id = '9f1c2d34-5678-4abc-9def-0123456789ab'
response = requests.put(
f'https://api.leavo.ai/backend/knowledge/{knowledge_id}',
headers={'Authorization': 'Bearer sua_chave_aqui'},
json={
'name': 'Política de trocas 2026',
'content': 'Trocas em até 45 dias mediante nota fiscal.'
}
)
print(response.json())
{
"id": "9f1c2d34-5678-4abc-9def-0123456789ab",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Política de trocas 2026",
"description": "Regras de troca e devolução",
"content": "Trocas em até 45 dias mediante apresentação da nota fiscal.",
"source_url": null,
"usage_instruction": "Use quando o lead perguntar sobre troca ou devolução.",
"assistant_id": null,
"excluded_assistant_ids": [],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-02-10T08:45:00Z"
}
Base de Conhecimento
Atualizar Conhecimento
Modifica um conhecimento existente ou muda o assistente dono
PUT
/
backend
/
knowledge
/
{id}
curl -X PUT "https://api.leavo.ai/backend/knowledge/9f1c2d34-5678-4abc-9def-0123456789ab" \
-H "Authorization: Bearer sua_chave_aqui" \
-H "Content-Type: application/json" \
-d '{
"name": "Política de trocas 2026",
"content": "Trocas em até 45 dias mediante apresentação da nota fiscal."
}'
const id = '9f1c2d34-5678-4abc-9def-0123456789ab';
const response = await fetch(`https://api.leavo.ai/backend/knowledge/${id}`, {
method: 'PUT',
headers: {
'Authorization': 'Bearer sua_chave_aqui',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Política de trocas 2026',
content: 'Trocas em até 45 dias mediante apresentação da nota fiscal.'
})
});
console.log(await response.json());
import requests
knowledge_id = '9f1c2d34-5678-4abc-9def-0123456789ab'
response = requests.put(
f'https://api.leavo.ai/backend/knowledge/{knowledge_id}',
headers={'Authorization': 'Bearer sua_chave_aqui'},
json={
'name': 'Política de trocas 2026',
'content': 'Trocas em até 45 dias mediante nota fiscal.'
}
)
print(response.json())
{
"id": "9f1c2d34-5678-4abc-9def-0123456789ab",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Política de trocas 2026",
"description": "Regras de troca e devolução",
"content": "Trocas em até 45 dias mediante apresentação da nota fiscal.",
"source_url": null,
"usage_instruction": "Use quando o lead perguntar sobre troca ou devolução.",
"assistant_id": null,
"excluded_assistant_ids": [],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-02-10T08:45:00Z"
}
Atualização parcial: envie apenas os campos que deseja mudar. Campos ausentes
permanecem como estão.
Path Parameters
string
obrigatório
UUID do conhecimento
Body
string
Novo nome (1 a 255 caracteres)
string
Nova descrição, até 1000 caracteres
string
Novo texto indexado. Substitui o conteúdo anterior.
string
Nova instrução de uso, até 2000 caracteres
string
Muda o escopo do conhecimento. Veja a tabela abaixo.
Mudando o assistente dono
O campoassistant_id tem três comportamentos distintos:
| O que você envia | Efeito |
|---|---|
| campo ausente | Escopo permanece como está |
"" (string vazia) | Torna o conhecimento global |
| UUID de um assistente | Vincula o conhecimento àquele assistente |
Enviar
"" é diferente de omitir o campo. A string vazia é o que remove o
vínculo com o assistente e devolve o conhecimento para o escopo global.Response
Retorna200 OK com o conhecimento atualizado.
curl -X PUT "https://api.leavo.ai/backend/knowledge/9f1c2d34-5678-4abc-9def-0123456789ab" \
-H "Authorization: Bearer sua_chave_aqui" \
-H "Content-Type: application/json" \
-d '{
"name": "Política de trocas 2026",
"content": "Trocas em até 45 dias mediante apresentação da nota fiscal."
}'
const id = '9f1c2d34-5678-4abc-9def-0123456789ab';
const response = await fetch(`https://api.leavo.ai/backend/knowledge/${id}`, {
method: 'PUT',
headers: {
'Authorization': 'Bearer sua_chave_aqui',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Política de trocas 2026',
content: 'Trocas em até 45 dias mediante apresentação da nota fiscal.'
})
});
console.log(await response.json());
import requests
knowledge_id = '9f1c2d34-5678-4abc-9def-0123456789ab'
response = requests.put(
f'https://api.leavo.ai/backend/knowledge/{knowledge_id}',
headers={'Authorization': 'Bearer sua_chave_aqui'},
json={
'name': 'Política de trocas 2026',
'content': 'Trocas em até 45 dias mediante nota fiscal.'
}
)
print(response.json())
{
"id": "9f1c2d34-5678-4abc-9def-0123456789ab",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Política de trocas 2026",
"description": "Regras de troca e devolução",
"content": "Trocas em até 45 dias mediante apresentação da nota fiscal.",
"source_url": null,
"usage_instruction": "Use quando o lead perguntar sobre troca ou devolução.",
"assistant_id": null,
"excluded_assistant_ids": [],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-02-10T08:45:00Z"
}
Vincular a um assistente
cURL
curl -X PUT "https://api.leavo.ai/backend/knowledge/9f1c2d34-5678-4abc-9def-0123456789ab" \
-H "Authorization: Bearer sua_chave_aqui" \
-H "Content-Type: application/json" \
-d '{"assistant_id": "3f8a1b2c-4d5e-6f70-8192-a3b4c5d6e7f8"}'
Tornar global novamente
cURL
curl -X PUT "https://api.leavo.ai/backend/knowledge/9f1c2d34-5678-4abc-9def-0123456789ab" \
-H "Authorization: Bearer sua_chave_aqui" \
-H "Content-Type: application/json" \
-d '{"assistant_id": ""}'
Substituir o arquivo
Envie comomultipart/form-data com o campo file. Valem as mesmas extensões e
o mesmo limite de 10 MB da criação.
cURL
curl -X PUT "https://api.leavo.ai/backend/knowledge/9f1c2d34-5678-4abc-9def-0123456789ab" \
-H "Authorization: Bearer sua_chave_aqui" \
-F "name=Manual do produto v2" \
-F "file=@manual_v2.pdf"
Erros
| Código | Descrição |
|---|---|
400 | Campo acima do limite de caracteres, name vazio, extensão não suportada ou arquivo acima de 10 MB |
401 | Chave de API ausente ou inválida |
404 | Conhecimento não encontrado, ou assistant_id não pertence a esta organização |
⌘I