> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Memory Store schemas

> Object schemas for Memory Stores, Memories, and Memory Versions.

## 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](#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) |