curl -X GET "https://api.leavo.ai/backend/knowledge" \
-H "Authorization: Bearer sua_chave_aqui"
const response = await fetch('https://api.leavo.ai/backend/knowledge', {
headers: {
'Authorization': 'Bearer sua_chave_aqui'
}
});
const conhecimentos = await response.json();
console.log(`${conhecimentos.length} itens na base`);
import requests
response = requests.get(
'https://api.leavo.ai/backend/knowledge',
headers={'Authorization': 'Bearer sua_chave_aqui'}
)
for item in response.json():
escopo = 'global' if item['assistant_id'] is None else 'exclusivo'
print(item['name'], '-', escopo)
[
{
"id": "9f1c2d34-5678-4abc-9def-0123456789ab",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Política de trocas",
"description": "Regras de troca e devolução",
"content": "Trocas em até 30 dias mediante nota fiscal...",
"source_url": null,
"usage_instruction": "Use quando o lead perguntar sobre troca.",
"assistant_id": null,
"excluded_assistant_ids": [],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-02-02T09:12:00Z"
},
{
"id": "1a2b3c4d-5e6f-4071-8293-a4b5c6d7e8f9",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Roteiro de qualificação",
"description": "",
"content": "Perguntas para qualificar o lead...",
"source_url": null,
"usage_instruction": null,
"assistant_id": "3f8a1b2c-4d5e-6f70-8192-a3b4c5d6e7f8",
"excluded_assistant_ids": [],
"created_at": "2026-01-20T14:00:00Z",
"updated_at": "2026-01-20T14:00:00Z"
}
]
Base de Conhecimento
Listar Conhecimentos
Lista os conhecimentos da organização e obtém um item específico
GET
/
backend
/
knowledge
curl -X GET "https://api.leavo.ai/backend/knowledge" \
-H "Authorization: Bearer sua_chave_aqui"
const response = await fetch('https://api.leavo.ai/backend/knowledge', {
headers: {
'Authorization': 'Bearer sua_chave_aqui'
}
});
const conhecimentos = await response.json();
console.log(`${conhecimentos.length} itens na base`);
import requests
response = requests.get(
'https://api.leavo.ai/backend/knowledge',
headers={'Authorization': 'Bearer sua_chave_aqui'}
)
for item in response.json():
escopo = 'global' if item['assistant_id'] is None else 'exclusivo'
print(item['name'], '-', escopo)
[
{
"id": "9f1c2d34-5678-4abc-9def-0123456789ab",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Política de trocas",
"description": "Regras de troca e devolução",
"content": "Trocas em até 30 dias mediante nota fiscal...",
"source_url": null,
"usage_instruction": "Use quando o lead perguntar sobre troca.",
"assistant_id": null,
"excluded_assistant_ids": [],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-02-02T09:12:00Z"
},
{
"id": "1a2b3c4d-5e6f-4071-8293-a4b5c6d7e8f9",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Roteiro de qualificação",
"description": "",
"content": "Perguntas para qualificar o lead...",
"source_url": null,
"usage_instruction": null,
"assistant_id": "3f8a1b2c-4d5e-6f70-8192-a3b4c5d6e7f8",
"excluded_assistant_ids": [],
"created_at": "2026-01-20T14:00:00Z",
"updated_at": "2026-01-20T14:00:00Z"
}
]
Retorna todos os itens de conhecimento da organização, globais e exclusivos de
assistentes.
Retorna
Response
Retorna200 OK com um array de objetos de conhecimento.
string
UUID do conhecimento
string
Nome de exibição
string
Texto indexado do conhecimento
string | null
null quando o conhecimento é global; UUID quando é exclusivo de um assistentearray
Assistentes que não enxergam este conhecimento global
curl -X GET "https://api.leavo.ai/backend/knowledge" \
-H "Authorization: Bearer sua_chave_aqui"
const response = await fetch('https://api.leavo.ai/backend/knowledge', {
headers: {
'Authorization': 'Bearer sua_chave_aqui'
}
});
const conhecimentos = await response.json();
console.log(`${conhecimentos.length} itens na base`);
import requests
response = requests.get(
'https://api.leavo.ai/backend/knowledge',
headers={'Authorization': 'Bearer sua_chave_aqui'}
)
for item in response.json():
escopo = 'global' if item['assistant_id'] is None else 'exclusivo'
print(item['name'], '-', escopo)
[
{
"id": "9f1c2d34-5678-4abc-9def-0123456789ab",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Política de trocas",
"description": "Regras de troca e devolução",
"content": "Trocas em até 30 dias mediante nota fiscal...",
"source_url": null,
"usage_instruction": "Use quando o lead perguntar sobre troca.",
"assistant_id": null,
"excluded_assistant_ids": [],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-02-02T09:12:00Z"
},
{
"id": "1a2b3c4d-5e6f-4071-8293-a4b5c6d7e8f9",
"tenant_id": "d6b10acc-2307-413f-a4de-4c2edf3f9a70",
"name": "Roteiro de qualificação",
"description": "",
"content": "Perguntas para qualificar o lead...",
"source_url": null,
"usage_instruction": null,
"assistant_id": "3f8a1b2c-4d5e-6f70-8192-a3b4c5d6e7f8",
"excluded_assistant_ids": [],
"created_at": "2026-01-20T14:00:00Z",
"updated_at": "2026-01-20T14:00:00Z"
}
]
Obter um conhecimento específico
GET /backend/knowledge/{id}
Path Parameters
string
obrigatório
UUID do conhecimento
200 OK com um único objeto de conhecimento, ou 404 se o item não
existir na sua organização.
curl -X GET "https://api.leavo.ai/backend/knowledge/9f1c2d34-5678-4abc-9def-0123456789ab" \
-H "Authorization: Bearer sua_chave_aqui"
const id = '9f1c2d34-5678-4abc-9def-0123456789ab';
const response = await fetch(`https://api.leavo.ai/backend/knowledge/${id}`, {
headers: {
'Authorization': 'Bearer sua_chave_aqui'
}
});
if (response.status === 404) {
console.log('Conhecimento não encontrado');
} else {
console.log(await response.json());
}
Erros
| Código | Descrição |
|---|---|
401 | Chave de API ausente ou inválida |
404 | Conhecimento não encontrado nesta organização |
⌘I