Skip to main content
GET
/
v2
/
knowledge
/
{knowledge_id}
Retrieves a knowledge base
curl --request GET \
  --url https://api.orq.ai/v2/knowledge/{knowledge_id} \
  --header 'Authorization: Bearer <token>'
{
  "_id": "<string>",
  "created": "<string>",
  "key": "<string>",
  "domain_id": "<string>",
  "updated": "<string>",
  "model": "<string>",
  "description": "<string>",
  "path": "Default",
  "created_by_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updated_by_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "internal",
  "retrieval_settings": {
    "retrieval_type": "hybrid_search",
    "top_k": 5,
    "threshold": 0,
    "rerank_config": {
      "rerank_model": "<string>",
      "top_k": 5,
      "rerank_threshold": 0.5
    },
    "agentic_rag_config": {
      "model": "<string>"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
knowledge_id
string
required

Unique identifier of the knowledge base

Response

Knowledge base retrieved

​
_id
string
required

The unique identifier of the knowledge base.

​
created
string
required

The creation date of the knowledge base.

​
key
string
required

The unique key of the knowledge base.

​
domain_id
string
required

The project/domain ID of the knowledge base.

​
updated
string
required

The last update date of the knowledge base.

​
model
string
required

The embeddings model used for the knowledge base.

​
description
string

The description of the knowledge base.

​
path
string

Entity storage path in the format: project/folder/subfolder/...

The first element identifies the project, followed by nested folders (auto-created as needed).

With project-based API keys, the first element is treated as a folder name, as the project is predetermined by the API key.

Example:

"Default"

​
created_by_id
string<uuid> | null
​
updated_by_id
string<uuid> | null
​
type
enum<string>
default:internal
Available options:
internal
​
retrieval_settings
object

The retrieval settings for the knowledge base. If not provider, Hybrid Search will be used as a default query strategy.