list_events
Retrieve the event stream for a discussion, including comments, polls, and reactions. Filter by event kind and page through results with limit and offset to trace reply trees or identify participants.
Instructions
Fetch the event stream for ONE discussion — new_comment, poll_created, stance_created, outcome_created, reaction, discussion_moved, etc. — with actor_id, kind, parent_id, created_at, and pointers to the underlying eventable record. Required: discussion_id. By default the connector paginates Loomio's v1/events endpoint up to a bounded cap and returns scope.complete; if you pass limit and/or offset, it returns exactly that one page. Optional kinds filters client-side after fetch. The response also embeds related comments, users, and polls arrays for in-place resolution. Use this to answer 'show me the reply tree for thread X', 'who participated in discussion Y', or as the building block for cross-discussion aggregations. Loomio's v1/events endpoint REQUIRES a discussion_id; there is no instance-wide, per-group, or per-user index. For user-centric questions across many discussions ('how active is X', 'compare members across groups'), use get_user_activity — do NOT loop list_events over every discussion yourself. get_user_activity does that fan-out server-side with concurrency control.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| discussion_id | Yes | ID of the discussion whose event stream to fetch. Required — Loomio's v1/events endpoint silently returns empty without it. | |
| limit | No | Page size for a single-page fetch. Omit limit/offset to let the connector paginate the full discussion stream up to its bounded cap. | |
| offset | No | Page offset (Loomio's `from` parameter). When supplied, list_events returns exactly that page instead of auto-paginating. | |
| kinds | No | Optional filter to only these event kinds (applied client-side after fetch — Loomio doesn't filter `kind` server-side). Common kinds: new_discussion, new_comment, comment_edited, poll_created, stance_created, outcome_created, discussion_moved, discussion_closed, reaction. |