> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leavo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Conhecimentos

> Lista os conhecimentos da organização e obtém um item específico

Retorna todos os itens de conhecimento da organização, globais e exclusivos de
assistentes.

## Response

Retorna `200 OK` com um array de objetos de conhecimento.

<ResponseField name="id" type="string">
  UUID do conhecimento
</ResponseField>

<ResponseField name="name" type="string">
  Nome de exibição
</ResponseField>

<ResponseField name="content" type="string">
  Texto indexado do conhecimento
</ResponseField>

<ResponseField name="assistant_id" type="string | null">
  `null` quando o conhecimento é global; UUID quando é exclusivo de um assistente
</ResponseField>

<ResponseField name="excluded_assistant_ids" type="array">
  Assistentes que não enxergam este conhecimento global
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.leavo.ai/backend/knowledge" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```

  ```javascript JavaScript theme={null}
  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`);
  ```

  ```python Python theme={null}
  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)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "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"
    }
  ]
  ```
</ResponseExample>

## Obter um conhecimento específico

```bash theme={null}
GET /backend/knowledge/{id}
```

### Path Parameters

<ParamField path="id" type="string" required>
  UUID do conhecimento
</ParamField>

Retorna `200 OK` com um único objeto de conhecimento, ou `404` se o item não
existir na sua organização.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.leavo.ai/backend/knowledge/9f1c2d34-5678-4abc-9def-0123456789ab" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```

  ```javascript JavaScript theme={null}
  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());
  }
  ```
</RequestExample>

### Erros

| Código | Descrição                                     |
| ------ | --------------------------------------------- |
| `401`  | Chave de API ausente ou inválida              |
| `404`  | Conhecimento não encontrado nesta organização |