Sign in
Memories

Create Memory Smart

Create a memory using the hybrid architecture.

By default, memories start in short-term storage (Redis) and are automatically promoted to long-term storage (PostgreSQL + Qdrant) when:

  • Accessed 3+ times (frequently used)
  • Content contains important keywords (orders, preferences, etc.)

Set force_long_term=true to skip short-term and store directly in long-term.

This is the recommended way to create memories.

post/api/v1/memories/smart

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Query parameters

force_long_termboolean

Force immediate long-term storage

ttlinteger nullable

Short-term memory TTL in seconds (overrides default if set)

Headers

X-API-Keystring nullable

Request body

contentstring required
titlestring nullable
scope'personal' | 'team' | 'department' | 'division' | 'organization' | 'global'

Memory visibility scope.

scope_idstring nullable
memory_type'short_term' | 'long_term' | 'semantic' | 'procedural'

Memory type classification.

classification'public' | 'internal' | 'confidential' | 'restricted'

Security classification levels.

required_clearanceinteger nullable
tagsstring[] nullable
entitiesobject nullable
extra_metadataobject nullable
source_typestring nullable
source_idstring nullable
retention_daysinteger nullable
ttlinteger nullable

Short-term memory TTL in seconds (overrides default if set)

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.