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

# Listar Bases de Conhecimento

> Retorna todas as bases de conhecimento cadastradas.

## Endpoint

`GET https://gateway.orkeia.ai/knowledge-bases`

**Autenticação**\
Requer cabeçalho `authorization:  <seu_token>`.

## Cabeçalhos

```
authorization: <seu_token>
```

## Exemplo (cURL)

```bash theme={null}
curl -X GET "https://gateway.orkeia.ai/knowledge-bases" \
  -H "authorization:  <seu_token>"
```

## Respostas

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": [
    {
      "id": "KB_123456",
      "name": "Base A",
      "description": "Descrição da base",
      "enabled": true,
      "sectors": ["hr"],
      "content": "https://storage.orkeia.ai/kb/base-a.pdf",
      "type": "file",
      "multimodal": false,
      "tags": ["tag1","tag2"]
    }
  ]
}
```

### 500 — Server Error

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Client Error

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```

## Campos

| Nome        | Tipo                      | Descrição                                                                                    |
| ----------- | ------------------------- | -------------------------------------------------------------------------------------------- |
| id          | string                    | Identificador único da base de conhecimento.                                                 |
| name        | string                    | Nome da base de conhecimento.                                                                |
| description | string                    | Descrição breve do conteúdo/uso.                                                             |
| enabled     | boolean                   | Indica se a base está ativa no ambiente.                                                     |
| sectors     | string\[]                 | Setores que podem consumir essa base (governança de acesso).                                 |
| content     | string                    | Fonte do conteúdo: caminho/URL do arquivo, link externo, ou texto literal (conforme `type`). |
| type        | "file" \| "url" \| "text" | Tipo do conteúdo.                                                                            |
| multimodal  | boolean                   | Se a base contém modalidades além de texto (imagens/áudio/vídeo).                            |
| tags        | string\[]                 | Metadados/etiquetas para busca e organização.                                                |