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

Search users

Searches users with optional NM-store system context support and query validation.

RBAC · user

Query parameters

querystringRequired
fieldsstringOptional
Controller query parser sends strings; schema expects an array of field names.
user_typestringOptional
role_idstring <uuid>Optional
team_idstring <uuid>Optional
include_inactivestringOptional
limitstringOptional

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.