/
Unreserve Specimens
Got feedback or spotted a mistake?

Leave a comment at the end of this page or email contact@krishagni.com

Unreserve Specimens

The specimens reserved for distribution to a specific project/distribution protocol can be cancelled using the below API. On cancellation, the specimens will become eligible for distribution to any project/DP satisfying the distribution criteria.

API

http[s]://<host>:<port>/openspecimen/rest/ng/distribution-protocols/{dp-id}/reserved-specimens

Method

PUT

Body

{ "cancelOp": true, "specimens": [ { "id": <spmn-id-1>, "cpShortTitle": <spmn-cp-1>, "label": <spmn-label-1>, "barcode": <spmn-barcode-1> }, { "id": <spmn-id-2>, "cpShortTitle": <spmn-cp-2>, "label": <spmn-label-2>, "barcode": <spmn-barcode-2> }, ... many more specimens ... ] }
  1. cancelOp attribute value should be true. Not including this attribute or using false or null will result in the reverse op i.e. reserving the specimens.

  2. {dp-id} is placeholder for the ID of distribution protocol for which the specimens are to be reserved.

  3. The specimens to be unreserved can be identified by any of the following mechanism:

    1. Unique specimen ID <spmn-id-1>, <spmn-id-2>

    2. CP short title and label tuple {<spmn-cp-1>, <spmn-label-1>}

    3. CP short title and barcode tuple {<spmn-cp-1>, <spmn-barcode-1>}

Related content

Sample Code To Reserve and Unreserve Specimens
Sample Code To Reserve and Unreserve Specimens
Read with this
Reserve Specimens
Reserve Specimens
Read with this
Query for specimens that are reserved, distributed or available
Query for specimens that are reserved, distributed or available
Read with this
Got feedback or spotted a mistake?

Leave a comment at the end of this page or email contact@krishagni.com