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

> Devuelve el historial de cambios de una base de conocimiento específica.

# Knowledge bases history id

## Endpoint

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

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

## Encabezados

```
authorization: <tu_token>
```

## Parámetros de Ruta

| 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/history" \
  -H "authorization:  <tu_token>"
```

## Respuestas

### Response - Éxito

```json response theme={null}
{
  "status": "OK",
  "data": [
    {
      "id": "hist_001",
      "responsible": "João Vitor",
      "responsibleId": "user_123",
      "action": "updated knowledge base",
      "type": "neutral",
      "date": "2024-07-22T18:00:00Z",
      "versionControl": "v1.0.1"
    }
  ]
}
```

### 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 del Historial

| Nombre         | Tipo   | Descripción                                                       |
| -------------- | ------ | ----------------------------------------------------------------- |
| id             | string | Identificador único del evento de historial.                      |
| responsible    | string | Nombre del responsable por la alteración.                         |
| responsibleId  | string | ID del usuario o sistema que realizó la alteración.               |
| action         | string | Acción registrada (ej.: created, updated, deleted).               |
| type           | string | Clasificación del evento (`success`, `fail`, `neutral`).          |
| date           | Date   | Fecha y hora de la alteración.                                    |
| versionControl | string | Identificador de la versión asociada al evento (si es aplicable). |
