Vector Search
Search your uploaded files and get back the matching passages.
Hybrid retrieval: dense (embedding) and sparse (keyword) matches are fused with
reciprocal rank fusion, so exact terms and paraphrases both work. Results are
chunks, each with its file_id, score and stored metadata — ready to drop into a
prompt as context.
Narrow the search with file_ids, a filter on the metadata you supplied at
upload, or a date_from / date_to window. top_k defaults to 5 (max 50).
Only files uploaded with embed are searchable. Each call embeds your query, so
it is a billed request — it counts against your rate limits and spend caps like
any inference call.
Authorizations
Enter your MeshAPI key (rsk_...) — sent as Authorization: Bearer <key>.
Headers
Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.
2026-08 Body
1 <= x <= 50Restrict to these file IDs
Match on any metadata key/value pairs
Unix timestamp — only chunks created after this
Unix timestamp — only chunks created before this
Response
Successful Response