Help Center/ Workspace/ API Reference/ Workspace APIs/ User Group/ Querying Users in a User Group

Updated on 2026-02-10 GMT+08:00

View PDF

Querying Users in a User Group

Function

Query users in a user group.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
workspace:userGroups:getUsers	List	userGroup *	-	-	-

URI

GET /v2/{project_id}/groups/{group_id}/users

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.
group_id	Yes	String	User group ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
user_name	No	String	The username supports fuzzy search.
description	No	String	The user description supports fuzzy search.
active_type	No	String	Activation type. USER_ACTIVATE: The subscriber is activated. ADMIN_ACTIVATE: activated by the administrator
enterprise_project_id	No	String	Enterprise project ID.
limit	No	String	Maximum number of desktops that can be returned in a pagination query. If this parameter is not specified or is set to 0, the default value 2000 is used. The maximum value is 2000.
offset	No	String	Start position for pagination query. The value starts from 0.

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
users	Array of UserInGroup objects	Users associated with the group.
total_count	Integer	Total number of users in the user list.

**Table 4** UserInGroup
Parameter	Type	Description
id	String	User ID.
user_name	String	Desktop username.
domain	String	Domain to which the user belongs.
user_email	String	User mailbox.
user_phone	String	Mobile number of the user.
total_desktops	Integer	Number of desktops of a user.
enterprise_project_id	String	Enterprise project ID.
description	String	User description

Example Requests

GET /v2/0bec5db98280d2d02fd6c00c2de791ce/groups/3ec05f83-b8a3-4c72-857f-b33f55943320/users

Example Responses

Status code: 200

Response to the list of users associated with the group.

{
  "total_count" : 2,
  "users" : [ {
    "user_name" : "user1",
    "user_email" : "xx1@mail.com",
    "user_phone" : "18818008887",
    "id" : "8357fd328c62447d94e452bf49xxxx"
  }, {
    "user_name" : "user2",
    "user_email" : "xx2@mail.com",
    "user_phone" : "18818008888",
    "id" : "8357fd328c62447d94e452bf495xxxx"
  } ]
}