# Operations with Specific Groups in the User Bundle

This resource lets you work with the user groups that are added to the specific set of users.
|  Resource  |     ```GENERIC /api/admin/customFieldSettings/bundles/user/{bundleID}/groups/{groupID} ```    |
| --- | --- |
|  Returned entity  |  [UserGroup](api-entity-UserGroup.html). For the description of the entity attributes, see [Supported Fields](#UserGroup-supported-fields) section.  |
|  Supported methods  |      * `GET`: [Groups in the User Bundle](#get-UserGroup-method).    * `DELETE`: [Groups in the User Bundle](#delete-UserGroup-method).    |

## UserGroup attributes

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)

### 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`.  |

## Read a Specific UserGroup

Get specified user group that belongs to the user bundle.

### Required permissions

Requires read access to the bundle.

### Request syntax

```GENERIC
GET /api/admin/customFieldSettings/bundles/user/{bundleID}/groups/{groupID}?{fields}
```

|  {groupID}  |  Database ID of the user group.  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of UserGroup attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.  |

### Sample

#### Sample request

```CURL
https://example.youtrack.cloud/api/admin/customFieldSettings/bundles/user/8-2/groups/3-5?fields=name,id,usersCount,icon,allUsersGroup,teamForProject(name)
```

#### Sample response body

```JSON
{
  "icon": null,
  "allUsersGroup": false,
  "teamForProject": {
    "name": "Sandbox",
    "$type": "Project"
  },
  "name": "Sandbox Team",
  "usersCount": 3,
  "id": "3-5",
  "$type": "UserGroup"
}
```

## Delete a Specific UserGroup

Removes specified group from the bundle.

### Required permissions

Requires Update Project permission in all projects where the bundle is used. If the bundle is not used in any field, Update Project permission is required in at least one project.

### Request syntax

```GENERIC
DELETE /api/admin/customFieldSettings/bundles/user/{bundleID}/groups/{groupID}
```

|  {groupID}  |  Database ID of the user group.  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of UserGroup attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.  |

### Sample

#### Sample request

```CURL
https://example.youtrack.cloud/api/admin/customFieldSettings/bundles/user/8-2/groups/3-5
```