latestOpenAPI 3.1.02026-08-101722118.3 KB
36cc62fb2aaf
List people and their AI usage.
get/users
Query parameters
toolstring
Filter to users who used a matching tool id or name.
departmentstring
Filter by department id or name.
period'last_30d' | 'all_time'
Usage window.
status'power_user' | 'active' | 'light' | 'dormant' | 'inactive'
Usage status.
sort'-usage' | 'usage' | '-sessions' | 'sessions' | '-spend' | 'spend' | 'name' | '-name'
Sort order.
limitinteger
Maximum rows to return.
cursorstring
Cursor from the prior response.
Headers
Oximy-Version'2026-06-29'
Optional dated API version. If sent, it must match the calling key's pinned version.
Response
Users list. Names and emails are only present with people:names:read.