List Feature Adoption People
GET/api/feature-adoption/people
Paginated list of the team's members (SKU staff excluded) with their activity in the window and a per-feature cell for every relevant feature they touched. bucket groups active days: 0 = none, 1 = 1-3, 2 = 4-10, 3 = 11+. Features without a cell had no activity.
reports:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Filters: filter[search] (id exact, name, email), filter[role] (raw role name = the row's role_key, comma-separated; role is the display label), filter[inactive] (true = no active day in the window, false = active only), filter[include_deactivated] (true = also list former users: deactivated, or removed from the account but with recorded activity here; they never count as seats). last_active_at is the last active day over all retained history, not just the window. Advanced id/name/email operators are supported.
Allowed sorts: id, name, email, last_active_at, active_days, features_used (prefix with - for descending; default -last_active_at).
Pagination: per_page default 10, max 200.
Authentication: Requires Bearer token with the reports scope.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.