List Workspace Facts

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/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-8001856949ad4f6a5b6226f415ffa877/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-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456&fact_fuzzy=deadline' \
  -H 'Authorization: Bearer sk_xxxxxx'

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

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/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-8001856949ad4f6a5b6226f415ffa877/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-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456&fact_fuzzy=deadline' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact-2fe07aee0058d141c744685a2d7272be",
        "fact": "Project deadline was moved to June 2025",
        "metadata": {
          "category": "planning"
        },
        "expired": false,
        "owner": {
          "type": "project",
          "id": "proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"
        },
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact-044bdc2ffcf8c7915aa9e79d5a10efd4",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences"
        },
        "expired": false,
        "owner": {
          "type": "actor",
          "id": "actor-8d093c0578ffeb19f8fa10ea28ee9362"
        },
        "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: one per kind of id you name — project:mem_read on each project in project_ids, workspace_actor:fact_read on each actor in actor_ids, and workspace_agent:fact_read on each agent in agent_ids. Naming something you may not read refuses the whole request; the list is not filtered down to what you can see.

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)

array of strings

Agent IDs whose facts to return; comma-separated.

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-8001856949ad4f6a5b6226f415ffa877/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-8001856949ad4f6a5b6226f415ffa877/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-8001856949ad4f6a5b6226f415ffa877/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, actor or agent this fact belongs to

Show Owner object

string

Owner type: project, actor or agent

string

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

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-2fe07aee0058d141c744685a2d7272be",
        "fact": "Project deadline was moved to June 2025",
        "metadata": {
          "category": "planning"
        },
        "expired": false,
        "owner": {
          "type": "project",
          "id": "proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"
        },
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact-044bdc2ffcf8c7915aa9e79d5a10efd4",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences"
        },
        "expired": false,
        "owner": {
          "type": "actor",
          "id": "actor-8d093c0578ffeb19f8fa10ea28ee9362"
        },
        "expiration_date": null,
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": null
  }
}

MemoryLake API

Memory Router API

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response