Sign in
Memories

Create Memory

Create a new memory.

The content will be embedded and stored in both Postgres (metadata) and Qdrant (vector + payload).

Required permissions: memory:create:{scope}

post/api/v1/memories

Request

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

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

idstring required
organization_idstring required
owner_idstring required
scopestring required
scope_idstring nullable required
memory_typestring required
classificationstring required
required_clearanceinteger required
titlestring nullable required
content_previewstring required
tagsstring[] required
entitiesobject required
extra_metadataobject required
source_typestring nullable required
source_idstring nullable required
access_countinteger required
last_accessed_atstring date-time nullable required
is_promotedboolean required
created_atstring date-time required
updated_atstring date-time required
scorenumber nullable

Changes

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