SmartMemory
POST
/memory/search

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.

Authorization

AuthorizationBearer <token>

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
  }
}