Flows

List flow events across sessions

Every session event in one feed, oldest first. Ids only increase, so starting_after is a durable high-water mark for a sync loop. Use flow_session, not session_id, to filter by session. Requires the read scope.

get/flow-events

Request

  • Base URL: https://sumgenius.ai/api/v1
  • URL: https://sumgenius.ai/api/v1/flow-events
  • Auth: one of:
    • API key in header X-SumGenius-Api-Key
    • HTTP bearer

Query parameters

flow_idinteger

One flow.

flow_sessioninteger

One session.

type'session_started' | 'node_entered' | 'node_exited' | 'branch_selected' | 'input_received' | 'link_clicked' | 'outcome_achieved' | 'session_completed' | 'session_expired' | 'session_cancelled' | 'session_reactivated'

Event type.

node_keystring

One step of the flow.

sincestring date-time

ISO-8601 UTC on occurred_at.

limitinteger

1 to 100, default 100.

starting_afterstring

The next_cursor from the previous page.

Response

A page

has_moreboolean required
next_cursorstring nullable required

Pass as starting_after for the next page. Null on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.