API reference · Access Control & Users v1
GET/api/v1/users

List users

Lists users using base list behavior and user query filters.

RBAC · user

Query parameters

pagestringOptional
limitstringOptional
sortstringOptional
orderstringOptional
usernamestringOptional
first_namestringOptional
last_namestringOptional
emailstringOptional
user_typestringOptional
role_idstring <uuid>Optional
team_idstring <uuid>Optional
is_inactivestringOptional
include_permissionsstringOptional
include_teamsstringOptional
fieldsstringOptional

Response body

Success response 200 · schema AccessApiPaginatedV1

dataarray of objectRequired
itemsobject
paginationobjectRequired
pageintegerRequired
limitintegerRequired
totalintegerRequired
totalPagesintegerRequired
hasNextbooleanRequired
hasPrevbooleanRequired
metaobject

Response codes

200
Paginated result set returned.
400
Validation failed (payload/query/path parsing).
401
API key missing/invalid or key user not found.
403
RBAC denied for user:read.
500
Unexpected controller/service failure.