This API is useful for mainly Update the user. You can update user through the HTTP PUT URL http://<host>:<port>/catissuecore/rest/ng/users/{userId}
Below are the attributes which need to be sent in the request body:
Parameter | Details |
|---|---|
| userId | User Id of the user |
| firstName | First name of the user |
| middleName | Middle name of the user |
| domainName | It is the name of the authentication domain. You cannot able to change domain of the user once user created |
| emailAddress | Email Address of the user. This attribute should be unique in catissue application |
| loginName | Login Name through which user can login to catissue application, should be unique in authentication domains. You cannot able to change domain of the user once user created |
| siteNames | Name of the sites to which the user belongs |
| cpTitles | Name of the collection protocols to which user belongs. |
| activityStatus | Activity status of the user, permissible values are {active, closed, pending, disabled} |
| deptName | Name of department to which user belongs |
| comments [optional] | comments on user given by admin while approval |
| country | Country of the user |
| state [optional] | state of the user |
| city [optional] | city of the user |
| zipCode | zipCode of the user |
| phoneNumber [optional] | Phone number of the user |
| faxNumber [optional] | Fax number of the user |
API Example :
| URL | catissuecore/rest/ng/users/{userId} |
| Method | PUT |
| Request | application/json |
| json | { "lastName":"Piterson", "firstName":"Sam", "domainName":"catissue", "emailAddress":"sam.piterson@live.com", "loginName":"samPiterson", "siteNames":["My group", "New Site"], "cpTitles":["MyCp", "Test Cp"], "activityStatus":"Active", "deptName":"Department of onchology", "comments":"bla bla bla", "city":"Jalgaon", "state":"Maharashtra", "country":"India", "zipCode":"425022", "faxNumber":"434343AS", "phoneNumber":"654323", } |
Response | { "id" : "1",
|
Error Cases :
code | Applies to | Status Message |
|---|---|---|
| 200 | All resources | User has been updated successfully |
| 400 | All requests | Invalid parameters, e.g duplicate Login Name, duplicate Email Address, blank First Name etc |
| 401 | All requests | Authorization failed, User doesn’t have Authority |
| 404 | All requests | User not found, User with given details not present in the system |
| 500 | All requests | Internal server error, Encountered server error while performing operations |