API Reference

Recall Memory

GET /v1/memories/recall

Retrieve relevant memories based on semantic search.

Query parameters

| Param | Type | Required | Description | |-------|------|----------|-------------| | userId | string | Yes | User ID | | query | string | Yes | What to search for | | appId | string | No | Filter by app | | limit | number | No | Max results (default: 5) | | minScore | number | No | Min similarity 0-1 (default: 0.7) | | format | string | No | string or array (default: string) |

Example

const context = await memory.recall({
  userId: 'user_123',
  query: 'what does the user prefer?'
})

curl "https://api.databaset.com/v1/memories/recall?userId=user_123&query=preferences&limit=5" \
  -H "Authorization: Bearer db_..."

Response (format=array)

{
  "memories": [
    {
      "id": "mem_abc",
      "text": "User prefers dark mode",
      "score": 0.94,
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "count": 1
}