v2

latestOpenAPI 3.1.02026-07-2664759910.6 KB
external
external-v2

List Events

List events for the authenticated account in sequence order. Events are a stable external projection over Mem domain events. They are thin by default; fetch full object state with the corresponding read API.

get/v2/events

Query parameters

after_sequenceinteger

Return events with a sequence greater than this value. Store next_after_sequence from each response as the next watermark.

Return events with a sequence greater than this value. Store next_after_sequence from each response as the next watermark.

limitinteger

Maximum number of events to return. Max: 1000.

Maximum number of events to return. Max: 1000.

typesExternalEventType[] nullable

Optional repeated event type filter, for example ?types=mem.note.created.v1&types=mem.conversation.message_received.v1.

Optional repeated event type filter, for example ?types=mem.note.created.v1&types=mem.conversation.message_received.v1.

entity_kindstring nullable

Optional primary entity kind filter, such as note.

Optional primary entity kind filter, such as note.

entity_idstring uuid nullable

Optional primary entity UUID filter.

Optional primary entity UUID filter.

Response

OK

has_moreboolean required

Whether more matching events are available after this page.

high_watermarkinteger required

Highest sequenced event currently visible for this account.

next_after_sequenceinteger required

Watermark to pass as after_sequence on the next poll. When no more matching events are currently available, this advances to the account high watermark.

request_idstring required

Identifier for this API request. Useful for tracing and support.