Knowledge

Search knowledge

Changed on

Search knowledge files by keyword. Pass recent=true without a keyword to browse recent files. When agent_id is set (shared agent), scope is the agent's configured knowledge bases.

get/knowledge/search

Request

  • Base URL
    /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/knowledge/search
  • Auth
    • API key in header Authorization
    • or API key in header X-API-Key

Query parameters

keywordstring

Keyword to search

offsetinteger

Offset for pagination (minimum 0)

limitinteger

Limit for pagination (default 20, maximum 100)

file_typesstring

Comma-separated file extensions to filter (e.g., csv,xlsx)

agent_idstring

Shared agent ID (search within agent's KB scope)

recentboolean

Return recent files when keyword is empty

Response

Search results

has_moreboolean
successboolean
totalinteger

Example response

{
  "success": true
}

Changes