> ## 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 Base History

> Returns the change history of a specific knowledge base.

## Endpoint

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

**Authentication**\
Requires header `authorization:  <your_token>`.

## Headers

```
authorization: <your_token>
```

## Path Parameters

| Name | Type   | Required | Description                       | Example    |
| ---- | ------ | -------- | --------------------------------- | ---------- |
| id   | string | Yes      | Identifier of the knowledge base. | KB\_123456 |

## Example (cURL)

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

## Responses

### Response - Success

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

## History Fields

| Name           | Type   | Description                                                   |
| -------------- | ------ | ------------------------------------------------------------- |
| id             | string | Unique identifier of the history event.                       |
| responsible    | string | Name of the person responsible for the change.                |
| responsibleId  | string | ID of the user or system that made the change.                |
| action         | string | Registered action (e.g., created, updated, deleted).          |
| type           | string | Classification of the event (`success`, `fail`, `neutral`).   |
| date           | Date   | Date and time of the change.                                  |
| versionControl | string | Version identifier associated with the event (if applicable). |