Skip to main content
POST
/
action
/
list_agent_memories
List Agent Memories
curl --request POST \
  --url https://api-lr.agent.ai/v1/action/list_agent_memories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": "50",
  "output_variable_name": "agent_memories",
  "agent_id_override": "<string>",
  "keyword_filter": "<string>",
  "metadata_filter": "<string>",
  "include_full_content": false
}
'
{
  "status": 123,
  "response": {}
}

Authorizations

​
Authorization
string
header
required

Bearer token from your account (https://agent.ai/user/integrations#api)

Body

application/json
​
limit
string
default:50
required

Maximum number of memories to return (default: 50).

Pattern: ^[0-9]+$
​
output_variable_name
string
default:agent_memories
required

Variable name to store the memory list, like 'agent_memories' or 'memory_list'.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*$
​
agent_id_override
string

Optionally list memories from a different agent. Leave empty to use current agent.

​
keyword_filter
string

Filter memories containing this keyword (e.g., "pricing", "enterprise", contact name).

​
metadata_filter
string

Filter memories by metadata key-value pairs. JSON format, e.g., {"meeting_title": "Q4 Review", "event_id": "event_123"}. Only memories matching ALL specified metadata will be returned.

​
include_full_content
boolean
default:false

Return full raw text content and metadata for each memory instead of just the summary.

Response

Successful response

​
status
integer<int32>

HTTP status code of the action response

​
response
object

Response data from the action