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{
    "id": 49,
    "label": "Brain Cancer CP - C123 - List1",
    "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": "Frozen Specimen - SP12314"
        },
        {
            "id": 13,
            "label": "Frozen 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.