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.
/v1/eventsRecorded 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
workspacestringoptionalquery parameter. One assigned Workspace. Required for keys with multiple assignments; inferred for one.
pagestringoptionalquery parameter. The previous memory cursor, with the same selection. Follow the returned nextPageUrl unchanged.
Min length: 1Max length: 131072
engramstringoptionalquery parameter.
Responses
A page and an opaque polling bookmark.
objectstringalways presentAllowed: "list"
urlstringalways presentAllowed: "/v1/events"
dataarrayalways presentShow item fields
idstringalways presentThe 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 presentWhat 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 presentRecorded 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 presentThe 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 presentShow nested fields
kindstringalways presentWhat 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 presentThe 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 presentThe affected Engram's total current Claims immediately before this transition. Zero for a new Engram.
Minimum: 0
claimCountAfterintegeralways presentThe affected Engram's total current Claims immediately after this transition. Zero when the identity is retired.
Minimum: 0
intoarrayalways presentNew Engram IDs created by a split. Empty for other transition kinds.
Show item fields
See the complete schema in the OpenAPI specification.
absorbedarrayalways presentEngram 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 presentWhen this transition was recorded, as an ISO-8601 timestamp. The enclosing Event's created field represents the same time in Unix seconds.
nextPageUrlstring | nullalways presentsincestringalways present