Skip to main content
POST
Search facts and documents together

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

Your own id for this request, which becomes the platform's request id. A retry carrying the same key is matched to the first request's usage record rather than billed again, so make it unique per request. A generated uuid is used when absent.

Body

application/json

Validates a POST /v1/memory/search body: the unified retrieval endpoint over the caller's personal scope, the workspace, and every collection in it, or over exactly the collections named in collection.

query
string
required
Maximum string length: 2000
collection
string[] | null

Omit it to blend every collection in the workspace; pass a collection slug, or a list of slugs, to read only those plus the caller's own personal memory. A slug the workspace does not have is rejected, never ignored.

Maximum string length: 255
user_ref
string | null
Maximum string length: 255
as_of
string<date-time> | null

The day the question is about, not the day it is asked. Omit it to search what is true now. Pass a date to search what was true then, which is the only way to reach a fact that has since been replaced: "where did I work in March" and "where do I work" are different questions with different right answers.

between
object

A SPAN, for the questions one day cannot answer: "how much did I spend on contractors last quarter" is about everything true across three months. means is required rather than defaulted, because "what I told you last year" and "what was true last year" are different sets of facts and guessing between them is silent. A span replaces as_of rather than narrowing it.

limit
integer | null
Required range: 1 <= x <= 50

Response

data
any[]
required