List Agent Facts

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-fe314186ccd18cde04d6af48a5afd79f/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/facts?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact-11a0e057d09877c9c492633fd60424fc",
        "fact": "Replies to support tickets in the customer's language",
        "metadata": {
          "category": "skills",
          "confidence": "high"
        },
        "expired": false,
        "score": 0.92,
        "expiration_date": null,
        "created_at": "2025-05-20T10:00:00Z",
        "updated_at": "2025-05-20T10:00:00Z"
      },
      {
        "id": "fact-9e6e9b323824eb264c1165994af65c1e",
        "fact": "Reports times in UTC",
        "metadata": {
          "category": "work"
        },
        "expired": false,
        "score": 0.85,
        "expiration_date": "2026-05-20T10:00:00Z",
        "created_at": "2025-06-01T16:45:00Z",
        "updated_at": "2025-06-01T16:45:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiZmFjdF8xYTJiM2M0ZDVlNmYifQ"
  }
}

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-fe314186ccd18cde04d6af48a5afd79f/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/facts?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact-11a0e057d09877c9c492633fd60424fc",
        "fact": "Replies to support tickets in the customer's language",
        "metadata": {
          "category": "skills",
          "confidence": "high"
        },
        "expired": false,
        "score": 0.92,
        "expiration_date": null,
        "created_at": "2025-05-20T10:00:00Z",
        "updated_at": "2025-05-20T10:00:00Z"
      },
      {
        "id": "fact-9e6e9b323824eb264c1165994af65c1e",
        "fact": "Reports times in UTC",
        "metadata": {
          "category": "work"
        },
        "expired": false,
        "score": 0.85,
        "expiration_date": "2026-05-20T10:00:00Z",
        "created_at": "2025-06-01T16:45:00Z",
        "updated_at": "2025-06-01T16:45:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiZmFjdF8xYTJiM2M0ZDVlNmYifQ"
  }
}

GET /openapi/memorylake/api/v3/workspaces/{workspaceId}/agents/{agentId}/facts

Returns a paginated list of an agent’s own facts in a workspace — what it has learned, and how it is meant to behave — accumulated across every project in the workspace.

Permission required: workspace_agent:fact_read

Path Parameters

string

required

Workspace ID

string

required

Agent ID

Query Parameters

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

string

Filter facts by content substring

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-fe314186ccd18cde04d6af48a5afd79f/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/facts?page_size=20' \
  -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

number

Relevance score

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-11a0e057d09877c9c492633fd60424fc",
        "fact": "Replies to support tickets in the customer's language",
        "metadata": {
          "category": "skills",
          "confidence": "high"
        },
        "expired": false,
        "score": 0.92,
        "expiration_date": null,
        "created_at": "2025-05-20T10:00:00Z",
        "updated_at": "2025-05-20T10:00:00Z"
      },
      {
        "id": "fact-9e6e9b323824eb264c1165994af65c1e",
        "fact": "Reports times in UTC",
        "metadata": {
          "category": "work"
        },
        "expired": false,
        "score": 0.85,
        "expiration_date": "2026-05-20T10:00:00Z",
        "created_at": "2025-06-01T16:45:00Z",
        "updated_at": "2025-06-01T16:45:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiZmFjdF8xYTJiM2M0ZDVlNmYifQ"
  }
}

MemoryLake API

Memory Router API

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response