Add Actor Facts

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-fe314186ccd18cde04d6af48a5afd79f/actors/actor_5e4d3c2b1a0f/facts' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "facts": [
      "Prefers metric units.",
      "Works in the Singapore office."
    ]
  }'

{
  "success": true,
  "data": {
    "facts": [
      {
        "id": "fact-45c6986397ee45d6a915ae51c79516bb",
        "fact": "Prefers metric units."
      },
      {
        "id": "fact-6773ba1dc34d4efc96e715efd8935026",
        "fact": "Works in the Singapore office."
      }
    ]
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-fe314186ccd18cde04d6af48a5afd79f/actors/actor_5e4d3c2b1a0f/facts' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "facts": [
      "Prefers metric units.",
      "Works in the Singapore office."
    ]
  }'

{
  "success": true,
  "data": {
    "facts": [
      {
        "id": "fact-45c6986397ee45d6a915ae51c79516bb",
        "fact": "Prefers metric units."
      },
      {
        "id": "fact-6773ba1dc34d4efc96e715efd8935026",
        "fact": "Works in the Singapore office."
      }
    ]
  }
}

POST /openapi/memorylake/api/v3/workspaces/{workspaceId}/actors/{actorId}/facts

Adds one or more facts to an actor in a workspace. Each string you send is stored exactly as written, as a new fact of its own — nothing is extracted, merged, or rewritten. Use this when you already know a fact and want it in memory directly; otherwise facts are extracted from conversations automatically. The response returns each created fact’s id and text, in the order you sent them. To read a fact’s metadata and timestamps, call Get Actor Fact. In the fact’s change history, a fact added this way starts with an ADD change whose source_kind is MANUAL.

Permission required: workspace_actor:fact_modify

Path Parameters

string

required

Workspace ID

string

required

Actor ID

Request Body

string[]

required

Fact texts to add, one fact per entry. The list must not be empty and no entry may be blank; otherwise the request is rejected with 400.

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-fe314186ccd18cde04d6af48a5afd79f/actors/actor_5e4d3c2b1a0f/facts' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "facts": [
      "Prefers metric units.",
      "Works in the Singapore office."
    ]
  }'

Response

object

Show Created facts

array

The created facts, in the order you sent them

Show Fact

string

Unique fact identifier

string

The fact text, exactly as you sent it

{
  "success": true,
  "data": {
    "facts": [
      {
        "id": "fact-45c6986397ee45d6a915ae51c79516bb",
        "fact": "Prefers metric units."
      },
      {
        "id": "fact-6773ba1dc34d4efc96e715efd8935026",
        "fact": "Works in the Singapore office."
      }
    ]
  }
}

MemoryLake API

Memory Router API

Path Parameters

Request Body

Response

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response