API ReferenceGroups
Group top users
List a group's most active identified users over a window. Organization-wide; requires owner/admin. Pass a group_type and a group_key from top_groups. The built-in company type is not supported here (use company_top_users). Returns resolved_identifier, events, and last_seen per user.
AuthorizationBearer <token>
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
group_type*string
The group type key, e.g. "workspace" or "team". Not "company".
Match
^[a-z][a-z0-9_]{0,63}$group_key*string
The group key within the type. Use top_groups to discover keys.
Length
1 <= length <= 512range_days?integer
Look-back window in days (1-365). Defaults to 30.
Range
1 <= value <= 365limit?integer
Maximum users to return (1-100). Defaults to 20.
Range
1 <= value <= 100Response Body
curl -X GET "https://example.com/groups/top-users?group_type=string&group_key=string"Empty