User Group Memberships

Quick Navigation

• GET Users/{userID}/UserGroups
• POST Users/{userID}/UserGroups/{userGroupID}
• DELETE Users/{userID}/UserGroups/{userGroupID}

GET Users/{userID}/UserGroups

Purpose

Returns the User Group Memberships for an existing User.

Required Permissions

User Accounts Management (Read)

URL Parameters

userID: ID of the User.

Request Body

None

Response Body

Content-Type: application/json

[
    {
        GroupID : int, 
        Name : string,
        DistinguishedName : string, 
        GroupType : string, 
        AccountAttribute : string, 
        MembershipAttribute : string,
        IsActive : bool
    },
    …
]

Response Codes

200 – Request successful. User Group in the response body.

For more information, please see Common Response Codes.

POST Users/{userID}/UserGroups/{userGroupID}

Purpose

Adds an existing User to a User Group.

Required Permissions

User Accounts Management (Read/Write)

URL Parameters

• userID: ID of the User.
• userGroupID: ID of the User Group.

Request Body

None

Response Body

Content-Type: application/json

{
    GroupID : int, Name : string,
    DistinguishedName : string, 
    GroupType : string, 
    AccountAttribute : string, 
    MembershipAttribute : string,
    IsActive : bool
}

Response Codes

201 – Request successful. User Group in the response body.

For more information, please see Common Response Codes.

DELETE Users/{userID}/UserGroups/{userGroupID}

Purpose

Removes a User from a User Group.

Required Permissions

User Accounts Management (Read/Write)

URL Parameters

• userID: ID of the User.
• userGroupID: ID of the User Group.

Request Body

None

Response Codes

200 – Request successful.

For more information, please see Common Response Codes.