# The Engram object

> A group of related claims, with a summary.

An Engram groups related Claims so your application can read a summary and inspect the
statements behind it. For example, Claims about owner approval and rollback preparation can
form an Engram about deployment rules. Augenta creates these groups when it processes your source.

One-shot [Consolidate](https://augenta.pages.dev/docs/consolidate.md) returns Engrams in its result; they exist only there and
cannot be retrieved later. A Workspace's Engrams form in the background and are read with the
operations below, by `id`. See [Engram IDs](https://augenta.pages.dev/docs/engrams.md#engram-ids) for lookup and continuity examples.

`claims` is included on detail reads and one-shot completed results. List reads load it when requested
with `include=claims`. It is a paginated collection: `claimCount` describes all current claims,
while `claims.data` contains only the loaded page. Recall returns separate model-context blocks.

## Available operations

* [GET `/v1/engrams` — List engrams](https://augenta.pages.dev/docs/api-reference/list-engrams.md)
* [GET `/v1/engrams/{id}` — Get an engram](https://augenta.pages.dev/docs/api-reference/get-engram.md)
* [GET `/v1/engrams/{id}/claims` — List an engram's claims](https://augenta.pages.dev/docs/api-reference/list-engram-claims.md)

## Attributes

These are response fields: always present can allow null; conditional fields can be omitted.

<a id="engram-object"></a>

### `engram.object`

`string` · always present

The resource type. Always engram. Use this field to recognize Engram objects in API results.

Allowed values: `"engram"`.

<a id="engram-id"></a>

### `engram.id`

`string` · always present

The ID Augenta assigns to this Engram, starting with `eng_`. In a Workspace, put this value in `GET /v1/engrams/{id}` to retrieve it. A one-shot Engram exists only in that result and has no standalone lookup URL. See [Engram IDs](https://augenta.pages.dev/docs/engrams.md#engram-ids) for examples and how IDs behave as memory changes.

<a id="engram-summary"></a>

### `engram.summary`

`string | null` · conditional

A readable summary of the Claims grouped in this Engram. Use it to display what the Engram is about. It can change as Claims or summary text change. Null when no summary is available; omitted when summaries:false is requested.

<a id="engram-label"></a>

### `engram.label`

`string | null` · conditional

A short topic label, such as releases · rollback, for display in lists. Augenta chooses terms that distinguish this Engram from others in the same Workspace or one-shot result. An empty string means no terms qualified; null means a label is unavailable. Omitted with summaries:false.

<a id="engram-labelsupport"></a>

### `engram.labelSupport`

`number | null` · conditional

How widely the label's terms appear in this Engram's Claims. For each term, Augenta calculates the share of Claims containing it, then averages those shares. Ranges from 0 to 1: at 1, every label term appears in every Claim. It is not confidence in the label's accuracy. Null when unavailable; omitted with summaries:false.

Minimum: `0`. Maximum: `1`.

<a id="engram-memoryclass"></a>

### `engram.memoryClass`

`string | null` · always present

The kind of content Augenta identified. Common values are `semantic` for facts, `episodic` for past events, `procedural` for how-to knowledge and `prospective` for commitments or future tasks. This does not select one-shot or Workspace mode. Null when unavailable.

<a id="engram-status"></a>

### `engram.status`

`string | null` · always present

The Engram's recorded state. `weakened` means its strength fell below half its recorded peak; it can return to `active` when its strength recovers. This describes retained memory, not Experience processing progress. Null when unavailable.

Allowed values: `"active"`, `"weakened"`, `null`.

<a id="engram-strength"></a>

### `engram.strength`

`number | null` · always present

A score describing the structural support for this Engram's group of Claims. Larger values indicate a stronger grouping under the memory process's scoring rules; this is not a probability or a measure of factual correctness. One-shot scores describe its last rebuild; Workspace scores come from its persisted memory history. Compare within the same memory, not across modes. Null when unavailable.

<a id="engram-heatshare"></a>

### `engram.heatShare`

`number | null` · always present

A relative activity measure: this Engram's share of the memory's recorded activity signal, called heat. Ranges from 0 to 1; 0.25 means one quarter of that memory's heat at the last evaluation. Workspace heat reflects incoming Claims and recorded recall activity; one-shot heat has no recorded recall activity. This is not confidence or billing usage. Null when unavailable.

Minimum: `0`. Maximum: `1`.

<a id="engram-claimcount"></a>

### `engram.claimCount`

`integer` · always present

The total number of Claims currently in this Engram. Use it to show the size of the group. It can exceed claims.data.length because only one page may be loaded; Claims that have left the Engram are excluded.

Minimum: `0`.

<a id="engram-claimtokencount"></a>

### `engram.claimTokenCount`

`integer | null` · always present

The total number of text tokens in this Engram's current Claims, excluding its summary. It describes content size, not tokens billed for a request or the size of your eventual model prompt. Null when unavailable.

Minimum: `0`.

<a id="engram-bornat"></a>

### `engram.bornAt`

`string | null` · always present

When this Engram ID was first published, as an ISO-8601 timestamp. It is not the date of the oldest source Claim. Null when the publication time is unknown for older memory.

<a id="engram-updatedat"></a>

### `engram.updatedAt`

`string | null` · always present

When the Engram's Claim membership or summary text last changed, as an ISO-8601 timestamp. A summary written after consolidation can advance it. Reads and changes only to scores, status or labels do not. It is not a version for the entire object. Null when the content-change time is unknown.

<a id="engram-claims"></a>

### `engram.claims`

`object` · conditional

A page of Claims currently in this Engram. Read claims.data for the statements and follow claims.nextPageUrl for more. Workspace detail and completed-memory results load an initial page by default; list requests need include=claims. An omitted field means Claims were not loaded, not that the Engram is empty.

<a id="engram-claims-object"></a>

### `engram.claims.object`

`string` · always present

The collection type. Always list.

Allowed values: `"list"`.

<a id="engram-claims-data"></a>

### `engram.claims.data`

`array<value>` · always present

Claims loaded on this page. A short or empty page can still have a continuation.

<a id="engram-claims-data-object"></a>

### `engram.claims.data.object`

`string` · always present

The resource type. Always claim.

Allowed values: `"claim"`.

<a id="engram-claims-data-id"></a>

### `engram.claims.data.id`

`string` · always present

The ID Augenta assigns to this statement, starting with clm\_. Use it to match a Claim in extractedClaims.data with the same Claim in an Engram's claims.data. It belongs to the Workspace or one-shot result that returned it.

<a id="engram-claims-data-text"></a>

### `engram.claims.data.text`

`string` · always present

The statement extracted from your source, such as Production releases require owner approval. Read this field for the Claim's content. Claims do not have labels.

<a id="engram-claims-data-experience"></a>

### `engram.claims.data.experience`

`string | null` · always present

The id of the Experience this Claim came from. In Workspace mode, use it with GET /v1/experiences/{id} to check processing status. Null means the source could not be identified for an older Claim.

<a id="engram-claims-data-at"></a>

### `engram.claims.data.at`

`string` · always present

When this statement was observed in its source, as an ISO-8601 timestamp. This is not the time you fetched the Claim.

<a id="engram-claims-data-source"></a>

### `engram.claims.data.source`

`object` · conditional

Additional source details, such as a conversation session or document path, when available. The fields depend on how the source was submitted. Omitted when no source details are available.

<a id="engram-claims-nextpageurl"></a>

### `engram.claims.nextPageUrl`

`string | null` · always present

Follow this relative URL unchanged. Null means there is no next page. One-shot output can still omit items when truncated is true.

<a id="engram-claims-url"></a>

### `engram.claims.url`

`string` · conditional

The collection's resource path, when available. Use nextPageUrl, rather than this path, to load the next page.

<a id="engram-claims-truncated"></a>

### `engram.claims.truncated`

`boolean` · conditional

True when a bounded one-shot result omitted items. One-shot results have no browsing continuation; use Workspace-backed memory when you need subsequent retrieval. False means all selected items were returned. Workspace lists use nextPageUrl instead.

<a id="engram-claims-billing"></a>

### `engram.claims.billing`

`object` · conditional

Present when billing is enabled. USD amount is exact. Receipt references settle only on successful server delivery; retries reuse the original debit.

<a id="engram-claims-billing-operationid"></a>

### `engram.claims.billing.operationId`

`string` · always present

<a id="engram-claims-billing-priceversion"></a>

### `engram.claims.billing.priceVersion`

`string` · always present

<a id="engram-claims-billing-sourcetokens"></a>

### `engram.claims.billing.sourceTokens`

`integer` · always present

Minimum: `0`.

<a id="engram-claims-billing-memorytokens"></a>

### `engram.claims.billing.memoryTokens`

`integer` · always present

Minimum: `0`.

<a id="engram-claims-billing-measuredmemorytokens"></a>

### `engram.claims.billing.measuredMemoryTokens`

`integer` · always present

Minimum: `0`.

<a id="engram-claims-billing-replayed"></a>

### `engram.claims.billing.replayed`

`boolean` · always present

<a id="engram-claims-billing-complimentary"></a>

### `engram.claims.billing.complimentary`

`boolean` · conditional

<a id="engram-claims-billing-ratedamount"></a>

### `engram.claims.billing.ratedAmount`

`string` · conditional

<a id="engram-claims-billing-amount"></a>

### `engram.claims.billing.amount`

`string` · always present

<a id="engram-claims-billing-receiptids"></a>

### `engram.claims.billing.receiptIds`

`array<string>` · always present

## Example object

```json
{
  "object": "engram",
  "id": "eng_000000000000000000000001",
  "summary": "Production releases require owner approval.",
  "label": "production · approval",
  "labelSupport": 1,
  "memoryClass": "semantic",
  "status": "active",
  "strength": 1.5,
  "heatShare": 0.25,
  "claimCount": 1,
  "claimTokenCount": 7,
  "bornAt": "2026-10-28T12:00:00.000Z",
  "updatedAt": "2026-10-28T12:00:00.000Z",
  "claims": {
    "object": "list",
    "data": [
      {
        "object": "claim",
        "id": "clm_000000000000000000000001",
        "text": "Production releases require owner approval.",
        "experience": "exp_000000000000000000000001",
        "at": "2026-10-28T12:00:00.000Z"
      }
    ],
    "nextPageUrl": null
  }
}
```
