Activity Feed
Last updated: 2026-05-20
Every group keeps a chronological audit log of everything that happens inside it — member changes, configuration tweaks, role assignments, hierarchy edits, lifecycle transitions, exports. The Activity tab on a group is your view onto that log.
Permissions —
group-audit-log:readon the group. The owner and any active member can read it by default; admins can grant read access more broadly via RBAC.
Opening the feed
Navigate to /groups/:groupId/activity. The tab is available in both the user and admin shells.
Each row shows:
- The event type (e.g.
MEMBER_ADDED,GROUP_UPDATED) - A human-readable description synthesized by the backend
- The actor that triggered the change (user, app, or service)
- The timestamp (relative + absolute on hover)
- A details panel with the structured
changesandmetadatapayloads
Filtering
Use the filter dropdown at the top right of the feed to narrow the timeline by category:
| Filter | Includes event types |
|---|---|
| All Activity | every event |
| Members | MEMBER_ADDED, MEMBER_REMOVED, MEMBER_ROLE_UPDATED, OWNERSHIP_TRANSFERRED, invitation events |
| Settings | GROUP_UPDATED, SETTINGS_UPDATED, GROUP_ROLE_ASSIGNED, GROUP_ROLE_REMOVED |
| Lifecycle | GROUP_CREATED, GROUP_ARCHIVED, GROUP_RESTORED, GROUP_DELETED, CHILD_GROUP_ADDED, CHILD_GROUP_REMOVED |
The counter under the header shows how many events match the current filter — e.g. 12 of 47 events.
Paging
The feed pages in chunks. Click Load More at the bottom to fetch the next page. The filter is applied client-side to the already-loaded pages — switch back to All Activity if you want to keep loading the full timeline.
What gets logged
The Activity feed is the user-facing view of GroupAuditLog. Every state-changing GraphQL mutation in the Groups module appends an entry. Categories covered:
- Lifecycle — create, update, archive, restore, delete
- Membership — add, remove, role-update, invitation send/accept/decline/cancel, ownership transfer
- Hierarchy — add child, remove child
- Settings — key-value setting create / update / delete, group-config update
- RBAC — role assignment / revocation on the group as an actor
- Rules — rule create / update / delete / sync execution
- Exports — per-group export jobs
Each entry stores:
eventTypedescriptionactorTypeandactorId- A structured
changesobject (the before/after diff or the action payload) - Optional
metadata ipAddressanduserAgentof the callercreatedAt
Workspace-wide audit
The per-group Activity tab is scoped to one group. For workspace-wide audit (e.g. "every group action in the last 24 hours, by any user") use the workspace Activity / Audit module. Group events flow through to the workspace audit pipeline via Kafka and are searchable there.
See also
- Managing members
- Group settings
- Permissions reference
- Spec:
../specs/07-events-activity-audit.md