catissuecore/rest/ng/users/{userId}
Use this resource to update the user. Use HTTP PUT method to call this API by passing the below details in JSON format.
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 has been 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 |
| roleNames | Name if the roles which user has. It can be one or many. By default its scientist in application |
| 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 |
http[s]:<host>:<port>/catissuecore/rest/ng/users/{userId}
Use this URL to update user in caTissue application.
Result:
The response of this request will contains the details of the udapted user.
Below is the example of the update user:
| URL | catissuecore/rest/ng/users/{userId} |
| Method | PUT |
| Request | application/json |
| json | { "lastName":"Roy", "firstName":"Sam", "domainName":"catissue", "emailAddress":"sam.piterson@live.com", "loginName":"samPiterson", "siteNames":["My group", "New Site"], "roleNames" : ["adminstrator"], "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, "lastName":"Piterson", "firstName":"Sam", "domainName":"catissue", "emailAddress":"sam.piterson@live.com", "loginName":"samPiterson", "siteNames":["My group", "New Site"], "roleNames" : ["adminstrator"], "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" } |
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 |