List Workspace Facts - MemoryLake AI

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456,proj_ghi789' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456&actor_ids=act-a1b2c3d4e5f6' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456&fact_fuzzy=deadline' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact_8f3a1b2c4d5e",
        "fact": "Project deadline was moved to June 2025",
        "metadata": {
          "category": "planning"
        },
        "expired": false,
        "owner": {
          "type": "project",
          "id": "proj_def456"
        },
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact_2d4e6f8a0b1c",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences"
        },
        "expired": false,
        "owner": {
          "type": "actor",
          "id": "act-a1b2c3d4e5f6"
        },
        "expiration_date": null,
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": null
  }
}

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

Returns facts across the given projects and/or actors in a workspace, newest first. Each fact is annotated with the project or actor it belongs to, so you can query knowledge workspace-wide without calling each project or actor endpoint separately. At least one project_ids or actor_ids entry is required, and the two combined must reference at most 50 distinct projects/actors.

Permission required: project:mem_list

Path Parameters

string

required

Workspace ID

Query Parameters

array of strings

Project IDs to include; comma-separated (e.g. proj-a,proj-b)

array of strings

Actor IDs to include; comma-separated (e.g. actor-a,actor-b)

string

Filter facts by content substring

integer

default:"50"

Number of facts to return per page. Range: 1–200.

string

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

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456,proj_ghi789' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456&actor_ids=act-a1b2c3d4e5f6' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456&fact_fuzzy=deadline' \
  -H 'Authorization: Bearer sk_xxxxxx'

Response

object

Show Paginated fact list

array

Array of fact objects

Show Fact object

string

Unique fact identifier

string

The fact text

object

Arbitrary key-value metadata attached to the fact

boolean

Whether the fact has been forgotten

object

The project or actor this fact belongs to

Show Owner object

string

Owner type: project or actor

string

Owner ID: a project ID when type is project, an actor ID when type is actor

string|null

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

string

Creation timestamp

string

Last update timestamp

string|null

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

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact_8f3a1b2c4d5e",
        "fact": "Project deadline was moved to June 2025",
        "metadata": {
          "category": "planning"
        },
        "expired": false,
        "owner": {
          "type": "project",
          "id": "proj_def456"
        },
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact_2d4e6f8a0b1c",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences"
        },
        "expired": false,
        "owner": {
          "type": "actor",
          "id": "act-a1b2c3d4e5f6"
        },
        "expiration_date": null,
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": null
  }
}

Delete Workspace List Conversations

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response