Skip to main content

Write memories

Write text entries into a namespace. Each entry is embedded and indexed for semantic search. You can attach optional metadata for filtering or display.

SDK

Batch write

Send multiple entries in one request:

REST API

POST /v1/memory/entries Headers: Authorization: Bearer key_...
Body:
Response (envelope):

Metadata

  • Optional. Use for filtering (e.g. metadata.source, metadata.userId) or for display in your UI.
  • Stored as JSON; avoid huge objects to keep responses and indexes lean.

Idempotency and updates

  • Each write creates new entries and new IDs. To “update,” write a new entry and optionally delete or deprecate the old one via your own logic or future delete API.
  • For idempotent writes, include a stable metadata.id and deduplicate in your app before calling write.
Next: Search to query these entries by meaning.