> ## 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.

# Knowledge bases detail

## Endpoint

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

**Autenticación**\
Requiere encabezado `authorization:  <tu_token>`.

## Parámetros de Camino

| Nombre | Tipo   | Obligatorio | Descripción                               | Ejemplo    |
| ------ | ------ | ----------- | ----------------------------------------- | ---------- |
| id     | string | Sí          | Identificador de la base de conocimiento. | KB\_123456 |

## Ejemplo (cURL)

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

## Respuestas

### Response - Éxito

```json response theme={null}
{
  "status": "OK",
  "data": {
    "id": "KB_123456",
    "name": "Políticas Internas",
    "description": "Documentos corporativos oficiales",
    "enabled": true,
    "sectors": ["hr", "legal"],
    "content": "https://storage.orkeia.ai/kb/policies.pdf",
    "type": "file",
    "multimodal": false,
    "tags": ["compliance", "contracts"]
  }
}
```

### 500 — Error del Servidor

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

### 400 — Error del Cliente

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

## Campos

| Nombre      | Tipo                      | Descripción                                                                                      |
| ----------- | ------------------------- | ------------------------------------------------------------------------------------------------ |
| id          | string                    | Identificador único de la base de conocimiento.                                                  |
| name        | string                    | Nombre de la base de conocimiento.                                                               |
| description | string                    | Descripción breve del contenido/uso.                                                             |
| enabled     | boolean                   | Indica si la base está activa en el ambiente.                                                    |
| sectors     | string\[]                 | Sectores que pueden consumir esta base (gobernanza de acceso).                                   |
| content     | string                    | Fuente del contenido: camino/URL del archivo, enlace externo, o texto literal (conforme `type`). |
| type        | "file" \| "url" \| "text" | Tipo del contenido.                                                                              |
| multimodal  | boolean                   | Si la base contiene modalidades además de texto (imágenes/audio/vídeo).                          |
| tags        | string\[]                 | Metadatos/etiquetas para búsqueda y organización.                                                |
