event
list
List events with optional type filter and cursor.
strata event listdb.events.list(event_type: 'Optional[str]' = None, *, limit: 'Optional[int]' = None, after_sequence: 'Optional[int]' = None, as_of: 'Optional[int]' = None, as_of_time: 'Optional[TimeLike]' = None) -> 'Page'wire event_list
Lists events from the selected branch and space in sequence order. An optional event type narrows the results, the sequence cursor continues a previous page, and the optional timestamp reads the log visible at that commit time.
Paginated responses use opaque cursors. Clients should pass the returned cursor back to the same command shape and must not parse cursor contents.
To see the complete help for this command, run:
strata event list --helphelp(db.events.list)
Example
List events in sequence order.
strata event append user.created {"id":1}strata event append user.updated {"id":2}strata event list
_ = db.events.append("user.created", {"id": 1})_ = db.events.append("user.updated", {"id": 2})[e.event.payload for e in db.events.list()]
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| after_sequence | integer or null | no | Optional exclusive sequence cursor. |
| as_of | integer or null | no | Read as of a position on the logical commit timeline - the `timestamp` from `history` output, not the `version`, and never a calendar date. To read as of a real time, use `as_of_time` instead. |
| as_of_time | integer or null | no | Read as of a real time: a wall-clock instant in microseconds since the Unix epoch (UTC), as reported by `committed_at` on a write ack or on any `history` row. Resolves to the commit at or before that instant, and fails rather than guessing if the instant falls outside the branch's recorded history. Mutually exclusive with `as_of`. |
| branch | string or null | no | Target branch. Defaults to the executor handle branch. |
| event_type | string or null | no | Optional event type filter. |
| limit | integer or null | no | Optional item limit. |
| space | string or null | no | Target product space. Defaults to `"default"`. |
Returns
Page<EventVersionedData, u64>
- dataobject
Shared pagination continuation facts.
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| invalid_argument.engine.product_space | never | not_started |
| invalid_argument.engine.event_type | never | not_started |
| invalid_argument.executor.limit | never | not_started |