Versions Compared

Key

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

Summary

This page contains documentation for update updating specimen list API.

Request Details

member is optional.
Parameter Details
labelA display name for Specimen-list.

sharedWith [optional]

 

Collection of Users with whom the list is shared with. This member is optional. This has the below attributes:
id(sharedWith) User id of the person with whom the list is shared with.
specimens [optional]Collection of specimens which belong to the given list. A Specimen-list can have one or more specimens in it. This has the below attributes:
id

(specimens) Identifier  Identifier of the specimen.

specimenListIdIdentifier of the specimen list.

 

Result

The response of this request will contain the details of the updated specimen-list.

URLhttp://<host>:<port>/catissuecore/rest/ng/specimen-lists/{specimenListId}
MethodPUT
Content-Typeapplication/json
Request

{

         "label": "Brain Cancer CP - C123 - S1",

         "sharedWith": [

        {

            "id": 2

        },

        {

            "id": 3

        }

    ],

         "specimens": [

        {

            "id": 12

        },

        {

            "id": 13

        }

    ]

}

Response{
       "status": "OK",
       "message": null,
       "exception": null,
       "erroneousFields": null,
       "specimenListDetails":
       {
           "    "id": 49,
               "label": "Brain Cancer CP - C123 - S1List1",
               "owner":
           {
                       "id": 1,
                       "firstName": "current-user",
                       "lastName": "current-user",
                       "loginName": "currentuser@example.com"
               },
               "sharedWith":
           [
                       {
                               "id": 3,
                               "firstName": "tech",
                               "lastName": "tech",
                               "loginName": "tech@tech.com"
                       },
                       {
                               "id": 2,
                               "firstName": "super",
                               "lastName": "super",
                               "loginName": "super@super.com"
                       }
               ],
               "specimens":
           [
                       {
                               "id": 12,
                               "label": "2Frozen Specimen - SP12314"
                       },
                       {
                               "id": 13,
                               "label": "3Frozen Specimen - SP12315"
                       }
               ]
       }
    }

...

Error Cases

code
Applies to
Status Message
200All resourcesSpecimen - list has been updated successfully.
400All requestsInvalid parameters, e.g  duplicate Specimen-list label, g Invalid User-ids, Invalid Specimen-ids.
401All requestsAuthorization failed, User doesn’t have Authority.
500All requestsInternal server error, Encountered server error while performing operations.