Skip to main content
PUT
Update knowledge-base search config

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

id
string
required

Knowledge base ID (kb_…).

Body

application/json
min_score

Minimum raw vector similarity (0..1) a chunk must clear to reach the agent. 0 = no floor (default).

recency_boost

Recency multiplier strength (0..5). 0 = off (default); fresher docs get up to ×(1 + boost).

recency_half_life_days

Half-life in days of the recency decay (1..3650). Default 30.

source_weights
object

Map of source label → score multiplier (0..20, keys matched case-insensitively). Default {}.

include_categories
string[]

Allow-list of categories; empty = allow all (default).

Maximum array length: 200
Required string length: 1 - 120
exclude_categories
string[]

Deny-list of categories. Default [].

Maximum array length: 200
Required string length: 1 - 120

Response

200 - application/json

The normalised search-config after the update.

data
object
required
meta
object
required