Skip to main content

SearchUsers

POST 
/v1/users/search

SearchUsers browses the directory the way the admin console's Users page needs (fraser#8695): a case-insensitive substring match on name or email, a status filter, and limit/offset paging with a total, so the console renders its numbered pages and stat cards without reading the auth DB directly (fraser#5521). The same users_reader gate and in-handler tenant boundary as GetUser/ListUsers apply.

An UNSPECIFIED status hides deleted users -- deleted_at IS NULL is the default everywhere active lists are rendered -- so a caller sees the active population unless it asks for USER_STATUS_DELETED explicitly. ACTIVE and BANNED also exclude deleted users: a delete is a separate state from an operator ban, not a flavor of one.

Request​

Responses​

Success