Skip to main content
GET
Search context vault

Authorizations

X-API-Key
string
header
required

API key created from the MemContext dashboard. Keys are prefixed with mc_, bound to one workspace, and API-key requests cannot override that workspace.

Query Parameters

workspaceId
string<uuid>

Optional for API-key calls because the key is bound to one workspace. Required for session callers selecting a workspace.

vaultId
string<uuid>

Optional vault inside the workspace. Defaults to the workspace's default vault.

query
string
required
Maximum string length: 1000
mode
enum<string>
default:hybrid
Available options:
memories,
documents,
hybrid
scope
string

Search one hard lane inside the workspace. Omit when using scopes.

Maximum string length: 200
scopes
string

Comma-separated scopes for multi-scope retrieval, for example dev,billing. Takes precedence over scope.

Maximum string length: 1000
project
string
Maximum string length: 100
limit
integer
default:8
Required range: 1 <= x <= 20

Response

200 - application/json

Company brain search results.

Ranked Context Vault retrieval results. chunks contains source document passages; memories contains extracted atomic facts with citation evidence or curated company facts. Hybrid mode returns these as separate arrays instead of a single merged list so callers can build downstream context blocks: source documents, extracted memories, and curated company facts. This response intentionally does not include a synthesized answer.

mode
enum<string>
required
Available options:
memories,
documents,
hybrid
found
integer
required
chunks
object[]
required

Source document chunks/passages. Empty when mode is memories.

memories
object[]
required

Extracted atomic memories with source evidence. Empty when mode is documents.