Memory Store object
| Field | Type | Description |
|---|---|---|
id | string | Unique ID (memstore_...) |
type | string | Always "memory_store" |
name | string | Human-readable name |
description | string | Description (empty string when unset) |
status | string | Store status; see Memory Store status |
entry_count | integer | Number of active memories in the store |
total_size | integer | Combined byte size of active memory content |
metadata | object | Key-value metadata |
archived_at | string | null | Timestamp when archived, or null |
created_at | string | RFC 3339 timestamp |
updated_at | string | RFC 3339 timestamp |
Memory Store status
| Value | Description |
|---|---|
active | Memories can be created and updated |
archived | Memories and versions can be read, but not created or updated |
Memory object
| Field | Type | Description |
|---|---|---|
id | string | Unique ID (mem_...) |
type | string | Always "memory" |
memory_store_id | string | Parent store ID |
path | string | Memory path |
content_size_bytes | integer | Content size in bytes |
content_sha256 | string | SHA-256 hex digest of content |
version | integer | Current version. Starts at 1, increments on each update |
metadata | object | Key-value metadata |
content | string | Full content. Returned on create, update, and single retrieval; omitted from list responses |
created_at | string | RFC 3339 timestamp |
updated_at | string | RFC 3339 timestamp |
Memory Version object
| Field | Type | Description |
|---|---|---|
id | string | Unique ID (memver_...) |
type | string | Always "memory_version" |
memory_store_id | string | Parent store ID |
memory_id | string | Parent memory ID |
path | string | Memory path at the time of the version |
content_size_bytes | integer | Content size in bytes |
content_sha256 | string | SHA-256 hex digest |
operation | string | One of created, updated, deleted |
redacted | boolean | Whether the version content has been redacted |
redacted_at | string | RFC 3339 timestamp of redaction. Present only when redacted is true |
content | string | Version content. Returned only on single retrieval and only when not redacted |
created_at | string | RFC 3339 timestamp |
Memory Version operation
| Value | Description |
|---|---|
created | The memory was created |
updated | The memory content was updated |
deleted | The memory was deleted (recorded as a tombstone version) |