latestOpenAPI 3.0.32026-08-10234358.4 KB

3d5d69795558

Users

List users

List and filter users for the specified account

get/user-service/users

Query parameters

searchstring

Search users by name or email using full-text search

emailstring email

Filter by exact email address match (returns single user or empty array)

type'USER' | 'SA'

Filter by user type - either regular USER or Service Account (SA)

role_idsstring[]

Filter by role IDs - users must have at least one of these roles

team_idsstring[]

Filter by team IDs - users must be members of at least one of these teams

limitinteger

Maximum number of users to return

offsetinteger

Number of users to skip

Response

Array of users matching the search criteria

total_countinteger

Total number of users matching the filter criteria

Example response

{
  "total_count": 42
}