Skip to content
AugentaDocsOpen console ↗
List events

Documentation

API reference
View Markdown

List events

Follow the returned nextPageUrl unchanged, preserving the original selection. An empty or short page can still have a continuation. See Pagination. After the final page, save since to poll for later recorded Events.

GET/v1/events

Recorded Engram lifecycle events in committed order, including when source clocks go backward. Each event has its own stable id and a recorded identity-lineage payload in data.object. This feed does not contain every score or summary update. Follow nextPageUrl to finish the selected event range. Save since to poll for later events, using the same Workspace, engram filter and limit. One-shot results have no durable event feed.

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

workspacestringoptional

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

limitintegeroptional

query parameter.

Minimum: 1Maximum: 500

Default: 100

pagestringoptional

query parameter. The previous memory cursor, with the same selection. Follow the returned nextPageUrl unchanged.

Min length: 1Max length: 131072

sincestringoptional

query parameter.

Min length: 1Max length: 4096

engramstringoptional

query parameter.

Responses

A page and an opaque polling bookmark.

objectstringalways present

Allowed: "list"

urlstringalways present

Allowed: "/v1/events"

dataarrayalways present
Show item fields
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

See the complete schema in the OpenAPI specification.

absorbedarrayalways present

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

Show item fields

See the complete schema in the OpenAPI specification.

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.

nextPageUrlstring | nullalways present
sincestringalways present