Skip to content
AugentaDocsOpen console ↗
Retrieve an event

Documentation

API reference
View Markdown

Retrieve an event

Retrieve the same immutable Event returned by the list. Select the Workspace whose memory produced it; current access is required even if you already have the Event ID.

GET/v1/events/{id}

Read an immutable recorded Engram lifecycle event by its evt_ id. Workspace access is checked on every request. The payload is the recorded lineage record, not the current Engram resource.

Authentication

Send your API key with the AugentaKey authorization scheme. Workspace requests must target a Workspace assigned to the key. See authentication and permissions.

Request

Parameters

idstringrequired

path parameter.

workspacestringoptional

query parameter. One assigned Workspace. Required for keys with multiple assignments; inferred for one.

Responses

The same Event resource returned in event lists.

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.