Skip to main content
POST
Search Knowledge Base
Use this API to run a semantic vector search over the content of your ingested knowledge base: the chunked, embedded text extracted from the files you’ve ingested. This is distinct from searching learned judgments (which search and ask read over). The endpoint is workspace-scoped.

Endpoint

POST https://api.velt.dev/v2/memory/knowledge/search

Headers

x-velt-api-key
string
required
Your API key.
x-velt-auth-token
string
required

Body

Params

data
object
required

Example Requests

Search a single source

Search across multiple sources

Search the whole workspace knowledge base

Response

Each result includes the matched sourceId, the chunk text, and a score: the cosine distance, where lower is more relevant. recordsSearched reports how many sources were queried.

Success Response

Failure Response