Knowledge bases

Update knowledge base

Updates a knowledge base's name, key, and/or desc. All fields are optional — send only what you want to change; an empty body is rejected. A changed key must remain unique in the project (409 on conflict). Returns 404 if the KB does not exist.

PATCH

https://api.nabrah.ai/api/ext/kb/{knowledge_base_id}

curl --request PATCH \
  --url 'https://api.nabrah.ai/api/ext/kb/<knowledge_base_id>' \
  --header 'X-API-Key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "desc": "Answers about billing, invoices, and refunds only."
}'

{
  "id": "00000000-0000-4000-8000-000000000000",
  "project_id": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "key": "string",
  "desc": "string",
  "document_count": 0,
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z"
}

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Path parameters

knowledge_base_idstringrequired

Identifier of the knowledge base to update.

From POST /api/ext/kb or GET /api/ext/kb.

Body

application/json

Refine when the agent should use this KB.

Update description

{
  "desc": "Answers about billing, invoices, and refunds only."
}

Response

200

Successful Response

application/json

422

Validation Error

application/json