API Docs

__METHOD= PUT . __PATH= /almaws/v1/users/{user_id} .

Update User Details

This Web service updates a specific user's details.

The update is done in a 'Swap All' mode: existing fields' information will be replaced with the incoming information. Incoming lists will replace existing lists.
Exception for this are the following fields:
roles - if the incoming list does not contain roles, existing roles will be kept.
External users: Preferred first name, Preferred middle name, Preferred last name, User group, Job category, PIN number, User language, Resource sharing libraries, Campus code and User title: these fields will not be replaced if updated manually (or if empty in the incoming user record), unless 'override' parameter is sent with the field's name.

Resource URL

PUT /almaws/v1/users/{user_id}

API Description

URL Parameters

user_idxs:stringA unique identifier for the user

Querystring Parameters

user_id_typexs:stringOptional. Default: all_uniqueThe type of identifier that is being searched. Optional. If this is not provided, all unique identifier types are used. The values that can be used are any of the values in the User Identifier Type code table.
overridexs:stringOptional.The following fields of the user object are not replaced if they were updated manually:
user_group, job_category, pin_number, preferred_language, campus_code, rs_libraries, user_title, library_notices, pref_first_name, pref_middle_name, pref_last_name, cataloger_level.
To update these fields, specify the fields you want to replace in this parameter.
For example override=user_group,job_category. Default is empty.
send_pin_number_letterxs:stringOptional. Default: falseThe email notification for PIN setting change will be sent
recalculate_rolesxs:stringOptional. Default: falseRecalculate the roles based on role assignment rules.
registration_rulesxs:stringOptional. Default: falseApply registration rules in the context of the library. True or false. Optional.
libraryxs:stringOptional.The code of the library. For use with registration rules. Optional.

Body Parameters

This method takes a User object. See doc


This method returns a User object. See doc

Possible Error Codes

401890User with identifier X of type Y was not found.
401859Action currently not supported.
401676No valid XML was given.
401858The external id in DB does not fit the given value in xml - external id cannot be updated.
401855The account type 'Internal with external authentication' is currently not supported.
500038New password must be at least 8 characters long and must not include the user-name or any commonly used password.
401860Failed to update user.
401652General Error: An error has occurred while processing the request.
401863Given X type (Y) is not supported for given user record type (Z).
401864Given X type (Y) is invalid.