Skip to main content
PATCH
/
v2
/
knowledge
/
{knowledge_id}
Updates a knowledge
curl --request PATCH \
  --url https://api.orq.ai/v2/knowledge/{knowledge_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "<string>",
  "path": "Default",
  "retrieval_settings": {
    "top_k": 5,
    "threshold": 0,
    "rerank_config": {
      "top_k": 5,
      "rerank_threshold": 0.5,
      "rerank_model": "<string>"
    },
    "agentic_rag_config": {
      "model": "<string>"
    }
  },
  "external_config": {
    "name": "<string>",
    "api_url": "<string>",
    "api_key": "<string>"
  },
  "type": "external"
}'
{
  "_id": "<string>",
  "created": "<string>",
  "description": "<string>",
  "key": "<string>",
  "domain_id": "<string>",
  "path": "Default",
  "created_by_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updated_by_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updated": "<string>",
  "type": "internal",
  "retrieval_settings": {
    "retrieval_type": "hybrid_search",
    "top_k": 5,
    "threshold": 0,
    "rerank_config": {
      "top_k": 5,
      "rerank_threshold": 0.5,
      "rerank_model": "<string>"
    },
    "agentic_rag_config": {
      "model": "<string>"
    }
  },
  "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

The unique identifier of the knowledge base

Body

application/json
  • Option 1
  • Option 2
​
description
string | null

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"

​
retrieval_settings
object

The retrieval settings for the knowledge base.

​
external_config
object

Configuration for the external knowledge base.

​
type
enum<string>
default:external
Available options:
external

Response

200 - application/json

Knowledge successfully updated

  • Option 1
  • Option 2
​
_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.