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.
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
Case-insensitive name prefix (empty = all)
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
}
}