Page Comparison

...

Use this resource to update the user in OpenSpecimen application. Use HTTP PUT method to call invoke 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
userIdid	Id ID of the user to be updated
firstName	First name of the user
lastName	Last name of the user
emailAddress	Email Address address of the user. This attribute should be unique in openSpecimen applicationis a unique key for the users.
phoneNumber	Phone number of the user, By default it will be blank
domainName	Name of the authentication domain . For providing domain name, domain should be already registered in application. By default its `openSpecimen` in application, it is 'openspecimen'.
loginName	Login Name name through which user can login to openSpecimen application, should be unique in authentication domains
deptName	Name of department to which user belongs
admin	Set user as superadmin. values are {true, false}.
address[optional]	Address of the user
activityStatus	Activity status of the user, permissible values are {active, closed, pending, disabled}sign-in to OpenSpecimen. This is a unique within the authentication domain.
instituteName	Institute to which the user is affiliated.
primarySite	Primary work site/lab of the user. This is an optional field.
type	User type. Permissible values are - SUPER, INSTITUTE, NONE. When set to SUPER, the user will be super administrator. The values INSTITUTE and NONE are for institute admin and regular users respectively.
manageForms	Boolean indicating whether user has rights to create/update custom forms. Default value is false.
address	Address of the user. This is an optional field
activityStatus	User status. The allowed values are - Active, Locked, Pending, Disabled.

http[s]:<host>:<port>/openspecimen/rest/ng/users/{userId}

...

URL

openspecimen/rest/ng/users/1

Method

PUT

Request

application/json

json

Code Block

language	js
theme	Eclipse
linenumbers	true

{
    "id": 1,
    "lastName": "Admin",
    "firstName": "Admin",
    "domainName": "openspecimen",
    "emailAddress": "admin@admin.com",
    "phoneNumber": "1234567890",
    "loginName": "admin@admin.com",
    "activityStatus": "Active",
    "

deptName

type": "

Immunology

SUPER",
    "

admin

instituteName":

true

 "Hospital for Rare Diseases",
    "address":

null

 "HRD, New City"
}

Response

Code Block

language	js
theme	Eclipse
linenumbers	true

{
    "id": 1,
    "lastName": "Admin",
    "firstName": "Admin",
    "domainName": "openspecimen",
    "emailAddress": "admin@admin.com",
    "phoneNumber": " 1234567890",
    "loginName": "admin@admin.com",
    "siteNames":
    [
    ],
    "creationDate": null1548909110207,
    "activityStatus": "Active",
    "instituteName": "A1Hospital -for ForRare Demo UsersDiseases",
    "deptNametype": "ImmunologySUPER",
    "adminaddress": true"HRD, New    "address": nullCity"
}

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

...

Versions Compared

Old Version 24

New Version Current

Key