Replaces the user's attributes in Cloud Directory.

Entitlement required: manageUserGroups (Manage users and groups), or manageAllUserGroups (Synchronize users and groups), or manageUserStandardGroups (Manage users and standard groups), or updateAnyUser (Update any user).
Note: You only need one entitlement, but you can have more than one.

On Success, the return response contains the user and group membership details. The HTTP PUT method is used to replace the resource's attributes. For example, clients that previously retrieved the entire resource and revised it, can replace the resource by using an HTTP PUT.

Only certain attributes for federated users can be modified unless you have the manageAllUserGroups entitlement. The user's groups cannot be modified and are ignored in the payload. Group membership is managed by using the PUT /v2.0/Groups/{id} and PATCH /v2.0/Groups/{id} API.

By default, an email is sent to regular users that includes the changed attributes. Federated users do not get an email notification. The email template for branding is at "notifications/user_management/profile/{locale}/user_profile_modified_email.xml". Pass in the themeId query parameter to brand the email template for notifications. To turn off email notifications, send the notifications option "urn:ietf:params:scim:schemas:extension:ibm:2.0:Notification": {"notifyType":"NONE"} in the payload.