# UserGroup

Represents a group of users.

## Related Resources

Below you can find the list of resources that let you work with this entity.

* [User Groups](resource-api-groups.html)

* [User Groups in the User Bundle](resource-api-admin-customFieldSettings-bundles-user-bundleID-groups.html)

Extended by:

* [AllUsersGroup](api-entity-AllUsersGroup.html)

* [RegisteredUsersGroup](api-entity-RegisteredUsersGroup.html)

* [ProjectTeam](api-entity-ProjectTeam.html)

* [NestedGroup](api-entity-NestedGroup.html)

## Attributes

This table describes attributes of the `UserGroup` entity.

* To receive an attribute in the response from the server, specify it explicitly in the `fields` request parameter.

* To update an attribute, provide it in the body of a POST request.

|  Field  |  Type  |  Description  |
| --- | --- | --- |
|  id  |  String  |  The ID of the user group. `Read-only`.  |
|  name  |  String  |  The name of the group.  |
|  ringId  |  String  |  ID of the group in Hub. Use this ID for operations in Hub, and for matching groups between YouTrack and Hub. `Read-only`. `Can be null`.  |
|  usersCount  |  Long  |  The number of users in the group. `Read-only`.  |
|  icon  |  String  |  The URL of the group logo. `Read-only`. `Can be null`.  |
|  allUsersGroup  |  Boolean  |  True if this group contains all users, otherwise false. `Read-only`.  |
|  users  |  [Array of Users](api-entity-User.html)  |  All users in this group, including transitive users. `Read-only`.  |