Search Entities

POST /agent/entities/search

Search for entities in the knowledge graph by name. Returns matching entities with fact counts and summaries.

Request

Body:

Field	Type	Required	Description
query	string	Yes	Search term (matched against entity names, case-insensitive)
volume_id	string (UUID)	Yes	Volume to search
limit	integer	No	Max results (default: 20)

Response

[
  {
    "name": "React",
    "type": "technology",
    "summary": "A JavaScript library for building user interfaces",
    "factCount": 12
  },
  {
    "name": "React Native",
    "type": "technology",
    "summary": "Mobile framework built on React",
    "factCount": 5
  }
]

Example

curl -X POST https://api.sharedmemory.ai/agent/entities/search \
  -H "Authorization: Bearer sm_agent_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "React",
    "volume_id": "a1b2c3d4-...",
    "limit": 10
  }'