Skip to main content
POST
Optimize User Memories

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

db_id
string | null

Database ID to use for optimization

table
string | null

Table to use for optimization

Body

application/json

Schema for memory optimization request

user_id
string
required

User ID to optimize memories for

model
string | null

Model in provider:model_id format. Current examples include openai:gpt-5.4-mini, anthropic:claude-sonnet-4-6, and google:gemini-3.5-flash. If omitted, Agno v2.7.4 uses MemoryManager's default model, gpt-4o.

apply
boolean
default:true

If True, apply optimization changes to database. If False, return preview only without saving.

Response

Memories optimized successfully

Schema for memory optimization response

memories
UserMemorySchema · object[]
required

List of optimized memory objects

memories_before
integer
required

Number of memories before optimization

Required range: x >= 0
memories_after
integer
required

Number of memories after optimization

Required range: x >= 0
tokens_before
integer
required

Token count before optimization

Required range: x >= 0
tokens_after
integer
required

Token count after optimization

Required range: x >= 0
tokens_saved
integer
required

Number of tokens saved through optimization

Required range: x >= 0
reduction_percentage
number
required

Percentage of token reduction achieved

Required range: 0 <= x <= 100