Delete a researcher's collection

A verified researcher is able to delete his/hers data collections.

{warning} Only collections in a deletable state can be deleted. A collection can only me deleted when it is not used any request.

Method Uri Auth Role
DELETE /v1/collections/{uuid} Bearer JWT-Token researcher

Headers

The API requires a header Accept to be submitted with the request:

{
    "Accept": "application/json",
    "Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3M..." 
}

Success Responses

Condition : User must be a researcher.

Code : 204 No-Content

Content example : Response will reflect back the created requests.

HTTP/1.1 204 No Content
Server: nginx/1.18.0 (Ubuntu)
Connection: close
Cache-Control: no-cache, private
Date: Mon, 01 Feb 2021 12:49:50 GMT
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57

Error Responses

Condition : If the current user does not have the role researcher attached.

Code : 403 Forbidden

{
  "message": "User does not have the right roles."
}

Condition : If the current collection is in a non-deletable state.

Code : 403 Forbidden

{
  "message": "You\'re not allowed to update this collection."
}