Skip to main content
POST
List Agent Memories

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