SmartMemory
GET
/memory/entities

List entity nodes admitted by the current scope, optionally by name prefix.

Backs Discord-style entity autocomplete (/recall about:<entity>). Entities are graph nodes (node_category = 'entity'), not metadata fields. Calling /by-metadata?metadata_key=entities does NOT work because entities are edge-connected, not embedded in a metadata list.

Entities are scoped through connected memory nodes by the scope provider, honoring USER and TENANT isolation. Empty prefix returns entities by name.

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

Query Parameters

prefix?Prefix

Case-insensitive name prefix (empty = all)

limit?Limit

Max entities to return

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/memory/entities"
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
  }
}