Skip to main content

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:read on 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 changes and metadata payloads

Filtering​

Use the filter dropdown at the top right of the feed to narrow the timeline by category:

FilterIncludes event types
All Activityevery event
MembersMEMBER_ADDED, MEMBER_REMOVED, MEMBER_ROLE_UPDATED, OWNERSHIP_TRANSFERRED, invitation events
SettingsGROUP_UPDATED, SETTINGS_UPDATED, GROUP_ROLE_ASSIGNED, GROUP_ROLE_REMOVED
LifecycleGROUP_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:

  • eventType
  • description
  • actorType and actorId
  • A structured changes object (the before/after diff or the action payload)
  • Optional metadata
  • ipAddress and userAgent of the caller
  • createdAt

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​