This API is available to delete the specimen.
Api :
...
catissuecore/rest/ng/specimens/{specimen_id}
...
Response
...
Parameter Details :
{specimen_id} : Specimen Id.
includeChildren: with this variable client can specify that whether to delete this specimen only or to delete all including child specimens.
default value: false, permissible values: true/false
Use this resource to delete an existing speicmen in the caTissue application. Use HTTP DELETE method to call this API by passing the below details:
Below are the parameters which need to be sent with the request:
Parameter | Details |
|---|---|
| specimen_id | Identifier of the specimen to whom you want to delete from caTissuePlus |
| includeDependents [optional] | This is optional parameter, set the value of this variable to true, if you also want to delete all the dependents of this specimen. If not set the default value is false. |
http[s]:<host>:<port>/catissuecore/rest/ng/specimens/{id}
Use this URL to delete specimens from caTissuePlus application.
Result:
The response of this request will contains the identifier of the deleted specimen and the success message.
Below is the example of the delete specimen:
| URL | http[s]:<host>:<port>/catissuecore/rest/ng/specimens/1/includeDependents=true |
| Method | DELETE |
| content-type | application/json |
Response | { "id" : "1"} |
Error Cases :
code | Applies to | Status Message |
|---|---|---|
| 200 | All resources | Specimen has been deleted successfully |
| 400 | All requests | If any active children found for this Specimen |
| 401 | All requests | Authorization failed, User doesn’t have privileges to delete this specimen |
| 404 | All requests | Specimen not found, Specimen with given identifier is not present in the system |
| 500 | All requests | Internal server error, Encountered server error while performing operations |