Get groups for a user

Overview

Use this API to retrieve groups for a department user. The groups within home as well as shared department are retrieved.

Permissions

Actor Permission
User All of the following are required:
  • If logged in user is a department user:
    • The user must have 'view permission' on the user provided in the request.
  • If logged in user is a global user, one of the following is required:
    • User must have 'Administer' permission on the departments of the user provided in the request.
    • User must have one of following privileges: 'View partition resources', 'Manage partition resources'.
Client Application No additional permission is required.
SecurityoAuthUser or oAuthClient
Request
path Parameters
id
required
string <= 255 characters

id of object

Example: 1001
query Parameters
$sort
string

Objects returned in server response are sorted based on the attribute supplied under $sort.

Enum: "id" "name"
$order
string

Common query parameter $order.

Enum: "asc" "desc"
$pagenum
string

Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize.
Default value: 1

$pagesize
string

Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum.
Default value: 25

$rangestart
string

Range parameter that specifies the starting index of the range of results to be returned. Used in conjunction with $rangesize.
Default value: 1

$rangesize
string

Range parameter that specifies the number (range) of results to be returned. Used in conjunction with $rangestart.
Default value: 25

header Parameters
Accept
required
string
Default: application/json

Content type accepted by client.

Enum: "application/json" "application/xml"
Accept-Language
required
string
Default: en-US

Language locale accepted by client (used for locale specific fields in resource representation and in error responses).

Enum: "en-US" "es-ES" "fr-FR" "it-IT" "de-DE" "nl-NL" "pt-BR" "pt-PT" "da-DK" "ru-RU" "fr-CA" "zh-CN" "ja-JP" "ko-KR" "sv-SE"
Responses
200

OK

204

No Content

  • No groups were found for the provided user.
  • Groups were found for the user, however the requested page or range doesn't contain any results.
400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

406

Not Acceptable

500

Internal server error

get/user/{id}/group
Request samples
Response samples
application/json
  • GET /core/usermgr/v3/user/1012/group
  • This example demonstrates the following:
    • Get groups of an user.
{
  • "group": [
    ],
  • "paginationInfo": {
    }
}