Skip to main content
POST
Vector search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

database
string
required

Target database.

Body

application/json

POST /v1/vector_search/{database}. Projection required; filter is an optional pushdown text pre-filter. Probe width and rerank budget are engine-decided (drain-time calibration) — there are no tuning knobs.

field_name
string
required
k
integer
required
Required range: x >= 0
projection
string[]
required
query
number<float>[]
required
table_name
string
required
filter
null | object

Optional text pre-filter for vector_search: kNN ranks only among rows whose FTS-indexed field_name matches query.

Response

Matching rows as an Arrow IPC stream (application/vnd.apache.arrow.stream), or JSON when the request sends Accept: application/json.

Last modified on August 19, 2026