> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ulm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove User from Group Process

This Process allows a Group's Primary User to remove another User from a Group, thereby removing that target User's access to an Account (and all Subscriptions and Features under that Account) associated to the Group.

**Note:** This Process is distinct from the [Revoke Access to an Account, Subscription, or Feature](c_revokeAccessASF) Process that only removes a single Subscription or Feature from a target User entity in a Group.

## Accounts, Associations, and Groups

Digital Identity Management enables account and service sharing by way of associations between Digital Identity Management Users, Digital Identity Management Groups, and Digital Identity Management Accounts (which contain Subscriptions and Features). See the intro sections in[Associate Billing Account](c_associateBillingAccountV2) and [Share Access to Account, Subscription, or Feature](c_shareAccessASF) Processes for more information. But here are a few basic reminders:

**Customer Accounts and Services as Digital Identity Management Accounts, Subscriptions, and Features**

* External accounts and services are mapped to Digital Identity Management Accounts, Subscriptions, and Features (A/S/F) entitlement entities.
* Each Account owns or contains Subscriptions, and each Subscription can contains its own Features.
* Mapping of external record data to Digital Identity Management entity data is based on an integration between Digital Identity Management and the service provider's external Billing / Operations Support System (B/OSS).

**Digital Identity Management Groups and Associations**

* When a user associates their account (i.e., when the Account/Subscription/Feature hierarchy are provisioned in Digital Identity Management), that account is automatically associated to the User, and to a Group in which the User is the "Group Primary."
* Either the Digital Identity Management User selects one of their existing Groups (if any exist), or a Group is automatically created and the A/S/F is associated to it.
* The Group to which an A/S/F is associated is sometimes referred to as the "Account Group", but it's technically known as a User Group first a foremost.
* The Digital Identity Management User who owns the A/S/F and the Group is designated the "Group Primary" or "Primary User"

**Account and Service Sharing by way of Multiple Associations**

* When the Primary User invites other Digital Identity Management Users to share access to an Account or Service, they select specific Digital Identity Management Accounts, Subscriptions, or Features (not necessarily all or even more than one entity).
* The Primary User also sets permissions for the invitee User to have (either consumption, management, or both).
* When the invitee accepts, their Digital Identity Management User entity is added to (i.e., associated to) the Digital Identity Management Group and the specified Accounts, Subscriptions, or Features.
* In order for any Digital Identity Management User to have access to an Account, Subscription, or Feature, they **must:**
  * Be associated to the Digital Identity Management Group
  * Be associated directly to the Specific Account, Subscription, or Feature
* When a user signs into an application, that application can call various connect API to check and see if the user is associated to the relevant entitlement entity, and then grant them access to that service.

If a Digital Identity Management User is removed from the Digital Identity Management Group, all associations they have to the A/S/Fs in that Group are also removed. In other words, this Process effectively kicks the target User out of the Group, and removes all access to all shared entitlement entities in that Group.

## Process Flow

This flow describes the Process at a high level.

**Preconditions**

* The user is currently authenticated
* The user has at least one account/service associated to their User ID, and they are the Primary User (owner).
* The target Digital Identity Management User is in at least one of the current user's Digital Identity Management Account Groups

**Basic Flow**

1. The current user selects to remove another Digital Identity Management User from their group.
2. The UI prompts the user to select a target user.
   * The client may need to leverage Digital Identity Management APIs to retrieve the relevant Group information (e.g., to what Groups is the current User associated, and what other Digital Identity Management Users are in those Groups)
3. The user selects a target user to remove.
   * The client must provide the selection using the target user's Digital Identity Management User `id` property.
4. (**Conditional**) If the user and the target user are in multiple Groups together, then Digital Identity Management prompts the client for a Group selection, and the UI prompts the user to select the specific Group
5. (**Conditional**) The user specifies the Group.
6. Digital Identity Management removes the target User entity from the Group.

**Post-conditions**

* The target User entity is disassociated from the specified Digital Identity Management Group.
* All associations between the target Digital Identity Management User and accounts or services from the Group are removed.

**Possible or Common Errors**

* The target user is not in any of the current user's groups.
* This current user does not have Primary or Admin permissions for the specified group.

## Settings

This Process currently has no relevant settings that configure the Process API response or Process logic/behaviour.

However, additional settings are coming in future releases.

## User Journey Diagram

This diagram illustrates the standard user journey using the **Remove User from Group** Process.

\[product: dim]<img src="https://mintcdn.com/amdocs-ulm/XSI-_zBHRIt1HJAz/portal/m1Connect/processGuide/images/m1c_userJourneyRemoveUserFromGroup.png?fit=max&auto=format&n=XSI-_zBHRIt1HJAz&q=85&s=3cbada41bd2ab697895b9e7cad490be4" alt="" width="1750" height="2193" data-path="portal/m1Connect/processGuide/images/m1c_userJourneyRemoveUserFromGroup.png" />\[/product: dim]

## Use Cases

The following use cases provide guided API walk-throughs of this Process for client developers:

* [Remove user from group (single group)](c_useCaseRemoveUser)

* [Remove user from multiple groups (multiple groups)](c_useCaseRemoveUserMultiple)

* [Remove user errors](c_removeUserErrors)

* **[Remove user from group](../topics/c_useCaseRemoveUser)**

* **[Remove user from group (multiple groups)](../topics/c_useCaseRemoveUserMultiple)**

* **[Remove user from group errors](../topics/c_removeUserErrors)**

**Parent topic:**[Account Association & Management Processes](../images/c_accountProcesses)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.