---
---
# Team user groups

## Fetch team user groups

[API doc](https://developers.lokalise.com/reference/list-all-groups)

```js
const user_groups = await lokaliseApi.userGroups().list({
  team_id: team_id,
  page: 2,
  limit: 1,
});

user_groups.items[0].group_id;
```

## Fetch a single group

[API doc](https://developers.lokalise.com/reference/retrieve-a-group)

```js
const user_group = await lokaliseApi.userGroups().get(group_id, {team_id: team_id});

user_group.group_id;
```

## Create group

[API doc](https://developers.lokalise.com/reference/create-a-group)

```js
const user_group = await lokaliseApi.userGroups().create(
  {
    name: 'Node',
    is_reviewer: false,
    is_admin: true,
    admin_rights: ['upload']
  },
  {team_id: team_id}
);

user_group.name;
```

## Update group

[API doc](https://developers.lokalise.com/reference/update-a-group)

```js
const user_group = await lokaliseApi.userGroups().update(
  group_id,
  {
    name: 'Node updated',
    is_reviewer: false,
    is_admin: true,
    admin_rights: ['upload']
  },
  {team_id: team_id}
);

user_group.permissions.is_admin;
```

## Add projects to group

[API doc](https://developers.lokalise.com/reference/add-projects-to-group)

```js
const user_group = await lokaliseApi.userGroups().add_projects_to_group(
  team_id,
  group_id,
  [project_id]
);

user_group.projects;
```

## Remove projects from group

[API doc](https://developers.lokalise.com/reference/remove-projects-from-group)

```js
const user_group = await lokaliseApi.userGroups().remove_projects_from_group(
  team_id,
  group_id,
  [project_id]
);

user_group.group_id;
```

## Add users to group

[API doc](https://developers.lokalise.com/reference/add-members-to-group)

```js
const user_group = await lokaliseApi.userGroups().add_members_to_group(
  team_id,
  group_id,
  [user_id]
);

user_group.members;
```

## Remove users from group

[API doc](https://developers.lokalise.com/reference/remove-members-from-group)

```js
const user_group = await lokaliseApi.userGroups().remove_members_from_group(
  team_id,
  group_id,
  [user_id]
);

user_group.members;
```

## Destroy group

[API doc](https://developers.lokalise.com/reference/delete-a-group)

```js
const response = await lokaliseApi.userGroups().delete(new_group_id, {team_id: team_id});

response.group_deleted;
```