List Facts - MemoryLake AI

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123def456/projects/proj_a1b2c3d4e5f6/memories/facts?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact_8f3a1b2c4d5e",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences",
          "confidence": "high"
        },
        "expired": false,
        "score": 0.95,
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact_2d4e6f8a0b1c",
        "fact": "User is based in San Francisco timezone (PST/PDT)",
        "metadata": {
          "category": "location"
        },
        "expired": false,
        "score": 0.88,
        "expiration_date": "2026-06-10T14:30:00Z",
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiZmFjdF8yZDRlNmY4YTBiMWMifQ"
  }
}

GET /openapi/memorylake/api/v3/workspaces/{workspaceId}/projects/{projectId}/memories/facts

Returns a paginated list of facts stored in a project. Facts are structured pieces of knowledge automatically extracted from conversations. You can filter by actor or include expired facts.

Permission required: project:mem_list

Path Parameters

workspaceId

string

required

Workspace ID

projectId

string

required

Project ID

Query Parameters

page_size

integer

default:"20"

Number of facts to return per page

continuation_token

string

Token from a previous response to fetch the next page of results

actor_id

string

Filter facts by a specific actor ID

expired

boolean

Include expired (forgotten) facts in the results

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123def456/projects/proj_a1b2c3d4e5f6/memories/facts?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'

Response

data

object

Show Paginated fact list

items

array

Array of fact objects

Show Fact object

string

Unique fact identifier

fact

string

The fact text

metadata

object

Arbitrary key-value metadata attached to the fact

expired

boolean

Whether the fact has been forgotten

score

number

Relevance score

expiration_date

string|null

Scheduled expiration date, or null if the fact does not expire

created_at

string

Creation timestamp

updated_at

string

Last update timestamp

continuation_token

string|null

Token to retrieve the next page. null when there are no more results.

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact_8f3a1b2c4d5e",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences",
          "confidence": "high"
        },
        "expired": false,
        "score": 0.95,
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact_2d4e6f8a0b1c",
        "fact": "User is based in San Francisco timezone (PST/PDT)",
        "metadata": {
          "category": "location"
        },
        "expired": false,
        "score": 0.88,
        "expiration_date": "2026-06-10T14:30:00Z",
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiZmFjdF8yZDRlNmY4YTBiMWMifQ"
  }
}

Delete Documents Get Fact

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response