# tcld user-group command reference

> User group management operations

The `tcld user-group` command user group management operations.

Alias: `ug`

- [tcld user-group list](#list)
- [tcld user-group get](#get)
- [tcld user-group create](#create)
- [tcld user-group set-access](#set-access)
- [tcld user-group add-users](#add-users)
- [tcld user-group remove-users](#remove-users)
- [tcld user-group list-members](#list-members)
- [tcld user-group delete](#delete)

### list

The `tcld user-group list` command list groups.

Alias: `l`

#### --page-token

list groups starting from this page token

Alias: `p`

#### --page-size

number of groups to list

Alias: `s`

### get

The `tcld user-group get` command get group.

Alias: `g`

#### --group-id

group ID

Alias: `id`

### create

The `tcld user-group create` command create a new user group.

Alias: `c`

#### --display-name

display name for the group

#### --account-role

account role (admin, read, developer, owner, financeadmin, none)

#### --namespace-role

namespace roles

Alias: `nr`

### set-access

The `tcld user-group set-access` command set group access.

Alias: `sa`

#### --group-id

group ID

Alias: `id`

#### --account-role

account role

Alias: `ar`

#### --namespace-role

namespace roles

Alias: `nr`

#### --append

append namespace roles, cannot be used with remove flag, cannot set account role

Alias: `a`

#### --remove

remove namespace roles, cannot be used with append flag, cannot set account role

Alias: `r`

### add-users

The `tcld user-group add-users` command add users to a group.

Alias: `au`

#### --group-id

group ID

Alias: `id`

#### --user-email

The email address of the user, you can supply this flag multiple times to add multiple users in a single request

Alias: `e`

#### --request-id

The request-id to use for the asynchronous operation, if not set the server will assign one (optional)

Alias: `r`

### remove-users

The `tcld user-group remove-users` command remove users from a group.

Alias: `ru`

#### --group-id

group ID

Alias: `id`

#### --user-email

The email address of the user, you can supply this flag multiple times to remove multiple users in a single request

Alias: `e`

#### --request-id

The request-id to use for the asynchronous operation, if not set the server will assign one (optional)

Alias: `r`

### list-members

The `tcld user-group list-members` command list all members of a group.

Alias: `lm`

#### --group-id

group ID

Alias: `id`

### delete

The `tcld user-group delete` command delete a user group.

Alias: `d`

#### --group-id

group ID

Alias: `id`

#### --request-id

The request-id to use for the asynchronous operation, if not set the server will assign one (optional)

Alias: `r`