me_memory_create

Store a new memory.

Parameters

Name	Type	Required	Description
id	string \| null	yes	UUIDv7 for idempotent creates. Pass null to auto-generate.
content	string	yes	The content of the memory. Must be non-empty.
meta	object \| null	yes	Key-value metadata pairs. Pass null to omit.
tree	string \| null	yes	Hierarchical path using dot-separated labels (e.g., work.projects.me). Pass null to store at the root.
temporal	object \| null	yes	Time range for the memory. Pass null to omit.

temporal

Name	Type	Required	Description
start	string	yes	ISO 8601 timestamp for the start of the time range.
end	string \| null	yes	ISO 8601 timestamp for the end. Pass null for a point-in-time memory.

Returns

The full memory object as created:

{
  "id": "0194a000-0001-7000-8000-000000000001",
  "content": "PostgreSQL 18 supports native UUID v7 generation.",
  "meta": { "topic": "database" },
  "tree": "notes.postgres",
  "temporal": null,
  "hasEmbedding": false,
  "createdAt": "2025-04-15T12:00:00Z",
  "createdBy": "user_abc",
  "updatedAt": null
}

Field	Type	Description
id	string	UUIDv7 identifier.
content	string	The memory content.
meta	object	Metadata key-value pairs (empty {} if none).
tree	string	Tree path (empty string if root).
temporal	object \| null	Time range with start and end, or null.
hasEmbedding	boolean	Whether a vector embedding has been computed yet.
createdAt	string	ISO 8601 creation timestamp.
createdBy	string \| null	The user that created the memory.
updatedAt	string \| null	ISO 8601 timestamp of last update, or null.

Example

{
  "id": null,
  "content": "Use ltree for hierarchical path queries in PostgreSQL.",
  "meta": { "source": "docs", "confidence": "high" },
  "tree": "research.postgres",
  "temporal": {
    "start": "2025-04-15T00:00:00Z",
    "end": null
  }
}

Notes

• When id is provided, the call is idempotent -- creating the same ID twice returns the existing memory.
• meta is fully replaced, not merged. Store the complete metadata object each time.
• Embeddings are computed asynchronously after creation. hasEmbedding will be false initially.