Top groups
List your organization's most active groups of a given type (e.g. teams or workspaces) over a window, sortable by active users, events, or last-seen. Organization-wide; requires owner/admin. The built-in company type is not supported here (use top_companies). Events are attributed to the group sent with each event, not current membership. Returns group_key, name, events, users, and last_seen per group.
Organization API Token (prefixed sk_) sent as Authorization: Bearer sk_.... Create one in Settings and grant it scopes. Server-side only.
In: header
Query Parameters
The group type key, e.g. "workspace" or "team". Not "company".
^[a-z][a-z0-9_]{0,63}$Look-back window in days (1-365). Defaults to 30.
1 <= value <= 365Sort field. Defaults to "users".
Value in
- "users"
- "events"
- "last_seen"
Maximum groups to return (1-200). Defaults to 50.
1 <= value <= 200Response Body
curl -X GET "https://example.com/groups/top?group_type=string"