Skip to main content
GET
/
knowledge-bases
/
:id

Endpoint

GET https://gateway.orkeia.ai/knowledge-bases/{id} Authentication
Requires header authorization: <your_token>.

Path Parameters

NameTypeRequiredDescriptionExample
idstringYesIdentifier of the knowledge base.KB_123456

Example (cURL)

curl -X GET "https://gateway.orkeia.ai/knowledge-bases/KB_123456" \
  -H "authorization:  <your_token>"

Responses

Response - Success

response
{
  "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

{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}

400 — Client Error

{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}

Fields

NameTypeDescription
idstringUnique identifier of the knowledge base.
namestringName of the knowledge base.
descriptionstringBrief description of the content/usage.
enabledbooleanIndicates whether the base is active in the environment.
sectorsstring[]Sectors that can consume this base (access governance).
contentstringSource of the content: file path/URL, external link, or literal text (according to type).
type”file” | “url” | “text”Type of the content.
multimodalbooleanWhether the base contains modalities beyond text (images/audio/video).
tagsstring[]Metadata/labels for search and organization.