Skip to main content
POST
Search an agent's knowledge bases

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

id
string
required

Agent identifier (Devotel agent_xxx id).

Body

application/json
query
string
required

Natural-language search query.

Required string length: 1 - 1000
kb_ids
string[]
required

Knowledge base ids to search. Each must be linked to this agent.

Required array length: 1 - 20 elements
limit
integer
default:5

Maximum number of merged results to return (1–20, default 5).

Required range: 1 <= x <= 20

Response

200 - application/json

Ranked knowledge-base search results

Ranked knowledge-base search results

data
object
meta
object