Memory

Search

GET /api/memory/search

Full-text search across all indexed memory and knowledge files.

curl "http://localhost:3000/api/memory/search?q=database+migrations&limit=5" \
  -H "X-API-Key: your-key"

Query Parameters

Parameter	Type	Default	Description
q	string	—	Search query (required)
limit	integer	10	Maximum results

Response

[
  {
    "source": "users/admin/memory/2026-03-15.md",
    "text": "## Migrations\n\nWe use sqlx for database migrations...",
    "line_start": 15,
    "line_end": 28
  }
]

Response Fields

Field	Type	Description
source	string	File path relative to the data directory
text	string	Matching text chunk
line_start	integer	First line of the chunk in the source file
line_end	integer	Last line of the chunk

Reindex

POST /api/memory/reindex

Rebuild the FTS5 search index. Run this after manually editing files in .starpod/db/.

curl -X POST http://localhost:3000/api/memory/reindex \
  -H "X-API-Key: your-key"

Response

{
  "status": "ok"
}