Skip to main content
Browse Documentation
HTTP - Management

Remove user from a group

Created by c.neale, last modified by s.yearsley on 24 Sep 2020

A user can be removed from a group by sending a DELETE request specifying the group and user identifiers.

DELETE/api/security/groups/{groupIdentifier}/users/{userIdentifier}

Parameters

NameParameter typeTypeFormatDescriptionExampleRequired
groupIdentifierpathstringgroup identifierFor convenience, Group resources can be referenced by using either the group name or id"Paper Street Soap Company" or "82f73a9b-2a13-4d63-bcc1-e8ee5047b01c"true
UserIdentifierpathstringuser identifierFor convenience, User resources can be referenced by using one of several identifiers - username, email address or Id."82f73a9b-2a13-4d63-bcc1-e8ee5047b01c" or "t.durden" or "t.durden@fightclub.com"true

Examples

Remove a user from a group by Id

DELETE: /api/security/groups/6254736c-70e1-43b0-b769-f8e0f6359862/users/3d063773-2ca9-4baf-90e1-ed674fa68640

Remove a user from a named group by Id

DELETE: /api/security/groups/Paper%20Street%20Soap%20Company/users/3d063773-2ca9-4baf-90e1-ed674fa68640

Remove a user from a group by username

DELETE: /api/security/groups/6254736c-70e1-43b0-b769-f8e0f6359862/users/tdurden

Remove a user from a group by email address

DELETE: /api/security/groups/6254736c-70e1-43b0-b769-f8e0f6359862/users/t.durden@fightclub.com

Responses

HTTP status codeReasonModel
204Success
401UnauthorizedError
403ForbiddenError
404Group not foundError
404User not foundError
404User not in groupError
500Internal server errorError