Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This API is available for update the role. You can update role through the HTTP PUT method, URL  http://<host>:<port>/catissuecore/openspecimen/rest/ng/roles/{roleId} 

Below Use this resource for update the role. 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
nameRole Name, Cannot be changes once role has been created
privilegeNames

Privilege names that comes under the role, permissible values are

{ User Provisioning, Storage Administration, Protocol Administration, Specimen Processing, Registration, Distribution, Read Denied }

...

description[optional]Description for role, By default it will be null


http[s]:<host>:<port>/openspecimen/rest/ng/roles/{roleId}

Use this URL to update role in openSpecimen application.


Result:

The response of this request will contains the details of the updated role.

Below is the example of the update role:

URLhttp://<host>:<port>/catissuecoreopenspecimen/rest/ng/roles/{roleId}
MethodPUT
Requestapplication/json
json{
    "name":"Scientiest",
    "privilegeNames" : ["Protocol Administration", "Registration"]
}

Response

{

    "id" : "1",

    "name":"Scientiest",

    "privilegeNames" : ["Protocol Administration", "Registration"] 
}

 

...

code
Applies to
Status Message
200All resourcesRole has been created successfully
400All requestsInvalid parameters, e.g  duplicate Role Namerole name, blank Role Name role name etc
401All requestsAuthorization failed, User user doesn’t have Authorityauthority
404All requestsRole not found, Role role with given details not present in the system
500All requestsInternal server error, Encountered encountered server error while performing operations

...