Search Memories - MemoryLake AI

POST /openapi/memorylake/api/v3/workspaces/{workspaceId}/memories/search

Searches across all memory sources in a workspace — documents and facts — using a natural language query. Results are grouped by source type so you can present each category separately or merge them in your UI. Use the optional filters to narrow results to specific projects, actors, or memory types.

Permission required: workspace:read

Path Parameters

string

required

Workspace identifier

Request Body

string

required

Natural language search query

array of strings

Limit search to specific projects. When omitted, all projects in the workspace are searched.

array of strings

Limit search to memories associated with specific actors

array of strings

Filter results by memory type. Accepted values: document, fact. When omitted, all types are searched.

integer

Maximum number of results to return per source type

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/search' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "What were the quarterly revenue figures?",
    "project_ids": ["proj_def456"],
    "memory_types": ["document", "fact"],
    "top_k": 10
  }'

Response

object

Show Search results grouped by source type

array

Document search results, grouped by source document

Show DocumentSearchResult

string

Document identifier

string

Display name of the document

string

Original file name

string

Summary of the document

string

Source type of the document (e.g. upload, connector)

string

Worksheet name, if the document is a workbook

array

Matched content items within the document

array

Fact search results

Show FactSearchResult

string

Fact identifier

string

The fact text

number

Relevance score

object

Additional metadata associated with the fact

string

Creation timestamp

string

Last update timestamp

{
  "success": true,
  "data": {
    "documents": [
      {
        "document_id": "doc-abc123",
        "document_name": "Q1 2024 Financial Report",
        "file_name": "q1_2024_report.pdf",
        "document_summary": "Quarterly financial report covering revenue, expenses, and projections for Q1 2024.",
        "source_type": "upload",
        "sheet_name": null,
        "items": [
          {
            "text": "Q1 2024 revenue reached $12.5M, a 15% increase over Q4 2023.",
            "range": "p8"
          }
        ]
      }
    ],
    "facts": [
      {
        "id": "fact-xyz789",
        "fact": "Company quarterly revenue for Q1 2024 was $12.5M",
        "score": 0.92,
        "metadata": {},
        "created_at": "2024-04-01T09:00:00Z",
        "updated_at": "2024-04-01T09:00:00Z"
      }
    ]
  }
}

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response