Search for memory items using semantic and contextual matching.
Optionally use SSG (Similarity Graph Traversal) for better multi-hop reasoning. Set use_ssg=true to enable SSG, or leave as null to use config default.
Requires authentication and operates on user-scoped data. SecureSmartMemory handles tenant isolation automatically via ScopeProvider.
Send Authorization: Bearer <token>. The token is either a Clerk session JWT or a SmartMemory API key (prefix sm_live_, sm_test_, or legacy sk_).
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request to search memory items.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/memory/search" \ -H "Content-Type: application/json" \ -d '{}'null{
"detail": {
"code": "invalid_scoped_validity",
"message": "string",
"retryable": false
}
}{
"detail": {
"code": "invalid_scoped_validity",
"message": "string",
"retryable": false
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}{
"detail": {
"code": "invalid_scoped_validity",
"message": "string",
"retryable": false
}
}Search Memory Get
Search for memory items using semantic and contextual matching (GET method).
Seed Patterns
Seed patterns from MEMORY.md TEXT (SM-PATTERN-CRUD-1). Returns created ids and skipped titles with reasons. Links that are absolute or climb with ``..`` are refused by the parser itself. ``refused`` carries the links the client declined to read (a symlink out of its dir). Titles already active in this workspace are skipped.