# 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

* [GET `/v1/events` — List events](https://augenta.pages.dev/docs/api-reference/list-events.md)
* [GET `/v1/events/{id}` — Retrieve an event](https://augenta.pages.dev/docs/api-reference/get-event.md)

## Attributes

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

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

### `event.object`

`string` · always present

The resource type. Always event.

Allowed values: `"event"`.

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

### `event.id`

`string` · always 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.

<a id="event-type"></a>

### `event.type`

`string` · always present

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

Allowed values: `"engram.created"`, `"engram.changed"`, `"engram.split"`, `"engram.merged"`, `"engram.retired"`.

<a id="event-created"></a>

### `event.created`

`integer` · always 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.

<a id="event-data"></a>

### `event.data`

`object` · always 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.

<a id="event-data-object"></a>

### `event.data.object`

`object` · always present

<a id="event-data-object-object"></a>

### `event.data.object.object`

`string` · always present

The recorded payload type. Always engram_change.

Allowed values: `"engram_change"`.

<a id="event-data-object-kind"></a>

### `event.data.object.kind`

`string` · always 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 values: `"born"`, `"update"`, `"split"`, `"merge"`, `"retire"`.

<a id="event-data-object-id"></a>

### `event.data.object.id`

`string` · always 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.

<a id="event-data-object-claimcountbefore"></a>

### `event.data.object.claimCountBefore`

`integer` · always present

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

Minimum: `0`.

<a id="event-data-object-claimcountafter"></a>

### `event.data.object.claimCountAfter`

`integer` · always present

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

Minimum: `0`.

<a id="event-data-object-into"></a>

### `event.data.object.into`

`array<string>` · always present

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

<a id="event-data-object-absorbed"></a>

### `event.data.object.absorbed`

`array<string>` · always present

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

<a id="event-data-object-at"></a>

### `event.data.object.at`

`string` · always present

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

## Example object

```json
{
  "object": "event",
  "id": "evt_2226fd14918857cbd289a8930000000000000100000000000001",
  "type": "engram.created",
  "created": 1790812800,
  "data": {
    "object": {
      "object": "engram_change",
      "id": "eng_000000000000000000000001",
      "kind": "born",
      "claimCountBefore": 0,
      "claimCountAfter": 1,
      "into": [],
      "absorbed": [],
      "at": "2026-10-01T00:00:00.000Z"
    }
  }
}
```
