Remove user from group (multiple groups)

In the edge case where the current Digital Identity Management User is the Primary of multiple Groups, and the target User to remove is in one or more of those same Groups, the Process prompts the end user to specify the Group from which to remove the target User. [product: dim]

[/product: dim]

Initial Request

Your client calls the Process Start API to initialize the Process:

**POST https://\{your.url\}/process/start/userManagement.RemoveUser.v1.0**
<no body>

Response: Specify User

Digital Identity Management responds with a prompt to specify the end user to remove from the current end user’s Group:

**RESPONSE - body**
{
   "processId": "3bdd10d2-8f2e-499e-be8e-b6679855e131",
   "processName": "userManagement.RemoveUser.v1.0",
   "stepName": "SelectUserPrompt",
   "parameters": {
      "userId": "long"
   }
}

`processId`	Unique identifier for the current instance of this Process.
`processName`	Full name of the Process, including the category and version number.
`stepName`	Name of the specific step that the Process is currently on.
`lastStep`	Boolean that indicates whether or not this was the last step in the Process.
`parameters`	Object that specifies the info this Process requires to continue its task.
`userId`	Digital Identity Management’s unique internal identifier of the user to remove (i.e., the `id` property on that Digital Identity Management User entity)

Next Request: Specify User

Once the current end user specifies who to remove, the client passes the target User entity’s id number through the Process Step API request:

**PUT https://\{your.url\}/process/step**
{
   "processId": "3bdd10d2-8f2e-499e-be8e-b6679855e131",
   "parameters": {
      "userId": "6014"
   }
}

`processId`	Unique identifier for the current instance of this Process.
`parameters`	Data object that contains the data that was requested in the previous Process response.
`userId`	Digital Identity Management’s unique internal identifier of the user to remove.

Response: Specify Group

Digital Identity Management returns a prompt to specify the target Group, and includes a list of applicable Digital Identity Management Groups wherein the current end user is the Primary User, and the target user is a Regular User.

**RESPONSE - body**
{
   "processId": "3bdd10d2-8f2e-499e-be8e-b6679855e131",
   "processName": "userManagement.RemoveUser.v1.0",
   "stepName": "SelectGroupPrompt",
   "lastStep": false,
   "displayMessage": "Please input required information",
   "output": {
      "1": "Group1",
      "2": "Group2"
   },
   "parameters": {
      "groupId": "String"
   }
}

`processId`	Unique identifier for the current instance of this Process.
`processName`	Full name of the Process, including the category and version number.
`stepName`	Name of the specific step that the Process is currently on.
`lastStep`	Boolean that indicates whether or not this was the last step in the Process.
`displayMessage`	Optional message that the UI can display to the end user.
`parameters`	Object that specifies the info this Process requires to continue its task.
`groupId`	The selected group, identified by the Digital Identity Management Group entity’s unique `id` number
`output`	Object that contains data that the client can consume, retain, and use for additional operations. In this case, each entry is a key-value pairing of an available Digital Identity Management Group’s `id`s with it’s display name, to assist the user in forming a selection. However, the client can leverage Digital Identity Management’s GET user/groups API to retrieve a more exhaustive list of each Group, if need be.

Final Request: Specify Group

The client passes the end user’s target Group from which to remove the target User:

**PUT https://\{your.url\}/process/step**
{
   "processId": "3bdd10d2-8f2e-499e-be8e-b6679855e131",
   "parameters": {
      "groupId": "1"
   }
}

`processId`	Unique identifier for the current instance of this Process.
`parameters`	Data object that contains the data that was requested in the previous Process response.
`groupId`	The end user’s selected group, identified by the Digital Identity Management Group entity’s unique `id` number.

Process Complete

The Process removes the target User from the specified Digital Identity Management Group, and returns an HTTP 200 status:

**RESPONSE - body**
{
    "processId": "3bdd10d2-8f2e-499e-be8e-b6679855e131",
    "processName": "userManagement.RemoveUser.v1.0",
    "lastStep": true,
}

`processId`	Unique identifier for the current instance of this Process.
`processName`	Full name of the Process, including the category and version number.
`lastStep`	Boolean that indicates whether or not this was the last step in the Process.
Parent topic:Remove User from Group Process

Home

Guides

APIs

Initial Request

Response: Specify User

Next Request: Specify User

Response: Specify Group

Final Request: Specify Group

Process Complete

​Initial Request

​Response: Specify User

​Next Request: Specify User

​Response: Specify Group

​Final Request: Specify Group

​Process Complete

Initial Request

Response: Specify User

Next Request: Specify User

Response: Specify Group

Final Request: Specify Group

Process Complete