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

# Detail Knowledge Base

> Returns detailed information about a specific knowledge base.

## Endpoint

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

**Authentication**\
Requires header `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" \
  -H "authorization:  <your_token>"
```

## Responses

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": {
    "id": "KB_123456",
    "name": "Internal Policies",
    "description": "Official corporate documents",
    "enabled": true,
    "sectors": ["hr", "legal"],
    "content": "https://storage.orkeia.ai/kb/policies.pdf",
    "type": "file",
    "multimodal": false,
    "tags": ["compliance", "contracts"]
  }
}
```

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

## Fields

| Name        | Type                      | Description                                                                                 |
| ----------- | ------------------------- | ------------------------------------------------------------------------------------------- |
| id          | string                    | Unique identifier of the knowledge base.                                                    |
| name        | string                    | Name of the knowledge base.                                                                 |
| description | string                    | Brief description of the content/usage.                                                     |
| enabled     | boolean                   | Indicates whether the base is active in the environment.                                    |
| sectors     | string\[]                 | Sectors that can consume this base (access governance).                                     |
| content     | string                    | Source of the content: file path/URL, external link, or literal text (according to `type`). |
| type        | "file" \| "url" \| "text" | Type of the content.                                                                        |
| multimodal  | boolean                   | Whether the base contains modalities beyond text (images/audio/video).                      |
| tags        | string\[]                 | Metadata/labels for search and organization.                                                |