---
title: "GET /api/v1/actions/userManagement/userGroups"
method: GET
path: "/api/v1/actions/userManagement/userGroups"
tags: ["User management"]
---

# GET /api/v1/actions/userManagement/userGroups

`GET /api/v1/actions/userManagement/userGroups`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/actions/userManagement/userGroups`
- Auth: none declared

## Query parameters

- `page` integer
- `size` integer
- `name` string
- `workspace` string
- `dataSource` string

## Response `200`

OK

- UserManagementUserGroups
  - `totalCount` integer, required: Total number of groups
  - `userGroups` UserManagementUserGroupsItem[], required
    - `dataSources` UserManagementDataSourcePermissionAssignment[], required
      - `accessSource` 'DIRECT' | 'GROUP': How the subject gains access to the data source (DIRECT or GROUP). Absent for direct-only listings.
      - `id` string, required: Id of the datasource
      - `name` string: Name of the datasource
      - `permissions` string[], required
    - `id` string, required
    - `name` string: Group name
    - `organizationAdmin` boolean, required: Is group organization admin
    - `userCount` integer, required: The number of users belonging to the group
    - `workspaces` UserManagementWorkspacePermissionAssignment[], required
      - `accessSource` 'DIRECT' | 'GROUP' | 'HIERARCHY': How the subject gains access to the workspace (DIRECT, GROUP, HIERARCHY). Absent for direct-only listings.
      - `hierarchyPermissions` string[], required
      - `id` string, required
      - `name` string
      - `permissions` string[], required

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)