Skip to main content
Run semantic search over a workspace’s layered chat memories and return hits plus a character budget (useful to bound length when injecting memory into context).

Endpoint

Authentication

Authorization: Bearer <jwt> or X-API-Key <sk_...>. Minimum role: viewer.

Path parameters

string
required
Workspace id.

Request body

string
Search text; falls back to the query query param when omitted.
integer
Maximum number of memories to return.
integer
Maximum character budget for returned content.

Response

array
Array of matched memories, each with content and other fields.
object
Budget statistics.

Example