Get Session Memory | Zep Documentation

curl https://api.getzep.com/api/v2/sessions/sessionId/memory \
     -H "Authorization: <apiKey>"

{
  "context": "string",
  "facts": [
    "string"
  ],
  "messages": [
    {
      "content": "string",
      "role_type": "norole",
      "created_at": "string",
      "metadata": {},
      "processed": true,
      "role": "string",
      "token_count": 1,
      "updated_at": "string",
      "uuid": "string"
    }
  ],
  "metadata": {},
  "relevant_facts": [
    {
      "content": "string",
      "created_at": "string",
      "fact": "string",
      "uuid": "string",
      "expired_at": "string",
      "invalid_at": "string",
      "name": "string",
      "rating": 1.1,
      "source_node_name": "string",
      "target_node_name": "string",
      "valid_at": "string"
    }
  ],
  "summary": {
    "content": "string",
    "created_at": "string",
    "metadata": {},
    "related_message_uuids": [
      "string"
    ],
    "token_count": 1,
    "uuid": "string"
  }
}

Returns a memory for a given session.

Path parameters

sessionIdstringRequired

The ID of the session for which to retrieve memory.

Query parameters

lastnintegerOptional

The number of most recent memory entries to retrieve.

minRatingdoubleOptional

The minimum rating by which to filter relevant facts.

Response

contextstring

Memory context containing relevant facts and entities for the session. Can be put into the prompt directly.

factslist of strings

Deprecated: Use relevant_facts instead.

messageslist of objects

A list of message objects, where each message contains a role and content. Only last_n messages will be returned

metadatamap from strings to any

Deprecated

relevant_factslist of objects

Most relevant facts to the recent messages in the session.

summaryobject

Deprecated: Use context string instead.

Errors

404

Not Found Error

500

Internal Server Error