Skip to main content

​
Endpoint

POST /v1/memory/search

​
Request Body

{
  "query": "facts/",
  "type": "semantic",
  "tags": ["architecture"],
  "limit": 10
}
ParameterTypeDescription
querystringCase-insensitive substring match on key
typestringFilter by memory type
tagsstring[]Filter by metadata tags (matches any)
limitnumberMax results (default 10, max 100)

​
Response (200)

{
  "results": [
    {
      "id": "...",
      "type": "semantic",
      "key": "facts/project-alpha",
      "version": 1,
      "sizeBytes": 42,
      "pinned": false,
      "importance": 0.8,
      "metadata": { "tags": ["architecture"] },
      "createdAt": "..."
    }
  ],
  "count": 1
}

​
Credit Cost

This operation costs 1 credit (search).