# Chalk CLI Reference: Authentication
source: https://docs.chalk.ai/cli#authentication

List your team's groups and, on a team that does not provision groups through SCIM, create, rename, and delete them and manage their members. Editing groups requires the team-wide `team.admin` permission and must be enabled for your team.

## `chalk authentication groups list`
source: https://docs.chalk.ai/cli?command=authentication_groups_list

```bash
chalk authentication groups list
```

Use the `list` command to see your team's groups, how many members each has, and the role each holds in the active environment.

Pass `--members` to list each group's members. Add or remove members with [`chalk authentication user-group-binding`](https://docs.chalk.ai/cli?command=authentication_user_group_binding_add).

**Flags**

- `--members <members>` (bool, default `false`)
  Also list each group's members.

**Example**

```
$ chalk authentication groups list
 Name          Group ID                   Members  Environment Roles
─────────────────────────────────────────────────────────────────────
 data-science  clnckmuj5000h0ks6vt139k6q  4        developer
 platform      clnckndq700040ls6pliorc87  2        admin
```

## `chalk authentication groups create`
source: https://docs.chalk.ai/cli?command=authentication_groups_create

```bash
chalk authentication groups create <name>
```

Use the `create` command to create an empty group.

Add members with [`chalk authentication user-group-binding add`](https://docs.chalk.ai/cli?command=authentication_user_group_binding_add). Editing groups by hand requires the team-wide `team.admin` permission and must be enabled for your team. A team whose groups come from an identity provider through SCIM manages them there instead.

**Arguments**

- `name` (string)
  The new group's name.

**Example**

```
$ chalk authentication groups create data-science
✓ Created group 'data-science' (clnckmuj5000h0ks6vt139k6q)
```

## `chalk authentication groups edit`
source: https://docs.chalk.ai/cli?command=authentication_groups_edit

```bash
chalk authentication groups edit <group>
```

Use the `edit` command to rename a group. Its members and role assignments are unchanged.

Editing groups by hand requires the team-wide `team.admin` permission and must be enabled for your team. A team whose groups come from an identity provider through SCIM manages them there instead.

**Arguments**

- `group` (string)
  The group to rename, given as a group id or a group name.

**Flags**

- `--name <new-name>` (string)
  The group's new name.

**Example**

```
$ chalk authentication groups edit data-science --name ml-research
✓ Renamed group 'data-science' to 'ml-research'
```

## `chalk authentication groups delete`
source: https://docs.chalk.ai/cli?command=authentication_groups_delete

```bash
chalk authentication groups delete <group>
```

Use the `delete` command to delete a group along with its memberships and role assignments.

Members lose the roles they held only through this group. The command asks for confirmation unless you pass `--yes`, which is required when stdin is not a terminal. A team whose groups come from an identity provider through SCIM deletes them there instead.

**Arguments**

- `group` (string)
  The group to delete, given as a group id or a group name.

**Flags**

- `-y, --yes <yes>` (bool, default `false`)
  Skip the confirmation prompt. Required when stdin is not a terminal.

**Example**

```
$ chalk authentication groups delete data-science --yes
✓ Deleted group 'data-science' (clnckmuj5000h0ks6vt139k6q)
```

## `chalk authentication user-group-binding add`
source: https://docs.chalk.ai/cli?command=authentication_user_group_binding_add

```bash
chalk authentication user-group-binding add <group> <user>...
```

Use the `add` command to add one or more team members to a group.

Users already in the group are left as they are. Members get the roles the group holds in each environment.

Editing groups by hand requires the team-wide `team.admin` permission and must be enabled for your team. A team whose groups come from an identity provider through SCIM manages them there instead.

**Arguments**

- `group` (string)
  The group, given as a group id or a group name.
- `user` (string)
  One or more team members, each given as a user id or an email address.

**Example**

```
$ chalk authentication user-group-binding add data-science alice@example.com bob@example.com
✓ Added 2 members to 'data-science'
```

## `chalk authentication user-group-binding remove`
source: https://docs.chalk.ai/cli?command=authentication_user_group_binding_remove

```bash
chalk authentication user-group-binding remove <group> <user>...
```

Use the `remove` command to remove one or more team members from a group.

Users who are not in the group are ignored. Members keep any role they hold individually.

Editing groups by hand requires the team-wide `team.admin` permission and must be enabled for your team. A team whose groups come from an identity provider through SCIM manages them there instead.

**Arguments**

- `group` (string)
  The group, given as a group id or a group name.
- `user` (string)
  One or more team members, each given as a user id or an email address.

**Example**

```
$ chalk authentication user-group-binding remove data-science alice@example.com bob@example.com
✓ Removed 2 members from 'data-science'
```
