Skip to content
AugentaDocsOpen console ↗
The Event object

Documentation

API reference
View Markdown

The Event object

An immutable record of an Engram identity transition.

Events describe recorded identity lineage with dotted types such as engram.created and engram.changed. The data.object payload is an engram_change, rather than the current Engram resource. It does not record every summary or score update.

Workspace Events have list and retrieve operations. One-shot Consolidate returns Event objects inline; they have no durable feed. Workspace Consolidate returns none. Events are generated by processing; there are no manual mutation or webhook-delivery routes.

Available operations

Usage and lifecycle →

The Event object

Attributes

These are response fields. “Always present” can still allow null; “conditional” means the field can be omitted.

objectstringalways present

The resource type. Always event.

Allowed: "event"

idstringalways present

The ID of this recorded Event, starting with evt_. Use it with GET /v1/events/{id} in the same Workspace. Read data.object.id for the affected Engram's eng_ ID. Snapshot Events are returned inline and have no stored lookup URL.

typestringalways present

What happened: an Engram was created, changed membership, split, merged or retired. These Events do not report every score or summary update.

Allowed: "engram.created""engram.changed""engram.split""engram.merged""engram.retired"

createdintegeralways present

Recorded event time as Unix seconds. Workspace event feeds follow committed order even when source clocks go backward; one-shot events describe the completed rebuild.

dataobjectalways present

The recorded identity-lineage payload. Completed memory results return the same Event resource in events. This is not a historical Engram snapshot or a complete score/prose audit.

Show nested fields
objectobjectalways present
Show nested fields
objectstringalways present

The recorded payload type. Always engram_change.

Allowed: "engram_change"

kindstringalways present

What happened to the affected Engram's identity or Claim membership. The enclosing Event exposes the corresponding dotted type, such as engram.created for born.

Allowed: "born""update""split""merge""retire"

idstringalways present

The ID of the Engram affected by this transition. This is an eng_ ID, not the Event's evt_ ID. The Engram may have been retired since this Event was recorded.

claimCountBeforeintegeralways present

The affected Engram's total current Claims immediately before this transition. Zero for a new Engram.

Minimum: 0

claimCountAfterintegeralways present

The affected Engram's total current Claims immediately after this transition. Zero when the identity is retired.

Minimum: 0

intoarrayalways present

New Engram IDs created by a split. Empty for other transition kinds.

Show item fields
absorbedarrayalways present

Engram IDs merged into this surviving Engram and retired. Empty for other transition kinds.

Show item fields
atstringalways present

When this transition was recorded, as an ISO-8601 timestamp. The enclosing Event's created field represents the same time in Unix seconds.