Skip to main content
Sent when memory changes are detected and the project is configured with memoryWebhookMode set to FULL_STATE (default). Contains the complete current memory state for the User/Persona pair. See the Memory Webhook guide for setup instructions.

​
Payload

{
  "event": "memory.updated",
  "data": {
    "userProfileId": "user_123",
    "personaProfileId": "persona_456",
    "memories": [
      {
        "uniqueIdentifier": "user_loves_italian_food",
        "target": "USER",
        "category": "FOOD_PREFERENCE",
        "description": "Loves Italian food, especially pasta carbonara",
        "eventStartDate": null,
        "eventEndDate": null,
        "sourceText": "I absolutely love Italian food, carbonara is my favorite!",
        "timestamp": "2026-04-10T14:30:00Z",
        "tags": ["italian", "pasta", "carbonara", "food"]
      },
      {
        "uniqueIdentifier": "user_lives_in_paris",
        "target": "USER",
        "category": "LOCATION",
        "description": "Lives in Paris, France",
        "eventStartDate": null,
        "eventEndDate": null,
        "sourceText": "I've been living in Paris for 3 years now",
        "timestamp": "2026-04-10T14:30:00Z",
        "tags": ["paris", "france", "location"]
      }
    ]
  }
}

​
Fields

FieldTypeDescription
eventstringAlways "memory.updated"
data.userProfileIdstringThe end-user’s profile identifier
data.personaProfileIdstringThe AI persona’s profile identifier
data.memoriesarrayComplete list of all current memories for this pair

​
Memory Object

FieldTypeDescription
uniqueIdentifierstringMachine-friendly key (e.g. user_loves_italian_food)
targetstringWho the memory is about: USER or PERSONA
categorystringContent category (see categories)
descriptionstringBrief English summary of the fact
eventStartDatestring | nullISO 8601 date (YYYY-MM-DD). Only for EVENT category
eventEndDatestring | nullISO 8601 date (YYYY-MM-DD). Only for EVENT category
sourceTextstringThe original message that produced this memory
timestampstringISO 8601 UTC timestamp when the memory was recorded
tagsstring[]Up to 10 keywords summarizing the memory

​
Memory Targets

TargetDescription
USERA fact about the end-user (the person chatting)
PERSONAA fact about the AI persona (as stated or implied during conversation)

​
Memory Categories

CategoryDescription
NAMEName
NICKNAMENickname or alias
AGEAge
DATE_OF_BIRTHDate of birth
GENDERGender
LOCATIONWhere they live or are located
NATIONALITYNationality or country of origin
LANGUAGELanguages spoken
RELIGIONReligious beliefs
CULTURECultural background
OCCUPATIONJob or professional role
EDUCATIONEducation level or school
SKILLSkills or abilities
PERSONALITYPersonality traits
APPEARANCEPhysical appearance
HEALTHHealth-related information
RELATIONSHIP_STATUSCurrent relationship status
ROMANTIC_RELATIONSHIPRomantic relationship details
FRIENDFriends mentioned
FAMILY_MEMBERFamily members mentioned
PETPets
SEXUAL_ORIENTATIONSexual orientation
SEXUAL_INTERESTSexual interests or preferences
POLITICAL_VIEWPolitical views
FOOD_PREFERENCEFood preferences
HOBBYHobbies and interests
MUSIC_PREFERENCEMusic taste
MEDIA_PREFERENCEMovies, TV shows, books, etc.
TECH_HABITTechnology usage habits
PROJECTPersonal projects or goals in progress
AMBITIONAmbitions or long-term goals
EVENTSpecific events with dates
OTHER_IMPORTANT_INFORMATIONAnything that doesn’t fit another category