Sign in

v1

latestOpenAPI 3.0.12026-08-041753011.2 MB
Group

Find all groups on a workspace

get/v1/workspaces/{workspaceId}/user-groups

Path parameters

workspaceIdstring required

Represents a workspace identifier across the system.

Example:64a687e29ae1f428e7ebe303

Represents a workspace identifier across the system.

Query parameters

project-idstring

If provided, you'll get a filtered list of groups that matches the string provided in their project id.

namestring

If provided, you'll get a filtered list of groups that matches the string provided in their name.

Example:development_team

If provided, you'll get a filtered list of groups that matches the string provided in their name.

sort-column'ID' | 'NAME'

Column to be used as the sorting criteria.

sort-order'ASCENDING' | 'DESCENDING'

Sorting mode.

pageinteger

Page number.

Example:1

Page number.

page-sizeinteger

Page size.

Example:50

Page size.

includeTeamManagersboolean

If provided, you'll get a list of team managers assigned to this user group.

Example:true

If provided, you'll get a list of team managers assigned to this user group.

Response

OK

idstring

Represents a user group identifier across the system.

namestring

Represents a user group name.

userIdsstring[]

Represents a list of users' identifiers across the system.

workspaceIdstring

Represents a workspace identifier across the system.

Example response

[
  {
    "id": "76a687e29ae1f428e7ebe101",
    "name": "development_team",
    "teamManagers": [
      {
        "id": "672323eb0024343a1585e8a7",
        "name": "Jane Doe"
      }
    ],
    "userIds": [
      "5a0ab5acb07987125438b60f",
      "98j4b5acb07987125437y32"
    ],
    "workspaceId": "64a687e29ae1f428e7ebe303"
  }
]