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

## Endpoint

`PUT 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 |

## Cuerpo de la Solicitud (JSON)

```json theme={null}
{
  "knowledgeBase": {
    "name": "Nuevo nombre",
    "description": "Nueva descripción",
    "enabled": true,
    "sectors": ["hr"],
    "content": "https://storage.orkeia.ai/kb/new-policies.pdf",
    "type": "file",
    "multimodal": false,
    "tags": ["updated"]
  },
  "filename": "new-policies.pdf"
}
```

> **Notas**
>
> * El envoltorio es el mismo que se usa en la creación, conteniendo `knowledgeBase` y `filename`.
> * Para `type: "file"`, envíe `filename` correspondiente al nuevo archivo (si aplica).

## Ejemplo (cURL)

```bash theme={null}
curl -X PUT "https://gateway.orkeia.ai/knowledge-bases/KB_123456" \
  -H "authorization:  <tu_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "knowledgeBase": {
      "name": "Nuevo nombre",
      "description": "Nueva descripción",
      "enabled": true,
      "sectors": ["hr"],
      "content": "https://storage.orkeia.ai/kb/new-policies.pdf",
      "type": "file",
      "multimodal": false,
      "tags": ["updated"]
    },
    "filename": "new-policies.pdf"
  }'
```

## Respuestas

### Response - Éxito

```json response theme={null}
{
  "status": "OK",
  "data": {
    "id": "KB_123456",
    "name": "Nuevo nombre",
    "description": "Nueva descripción",
    "enabled": true,
    "sectors": ["hr"],
    "content": "https://storage.orkeia.ai/kb/new-policies.pdf",
    "type": "file",
    "multimodal": false,
    "tags": ["updated"]
  }
}
```

### 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
}
```