DELETE drillable

Deletes an existing drill or course only if the drill or course has one owner (no co-authors) and the owner of the drill or course is the caller. If there are co-authors only the co-authorship of the caller will be removed but the drill or course will remain untouched.

Resource URL

https://www.drillster.com/api/2.1.1/drillable/{drillable_id}

Parameters

Field Type Description
drillable_id
required		 String The ID of the drillable to be deleted.

Example value: 9YMJPGVci_R_iyqeh3SLO9
ignoreWarnings
optional		 Boolean Whether to forcibly remove the drillable, even if there are warnings.

Response

A 2.1.1 NoContent (204) response indicating a successful deletion, or an HTTP Precondition Required (428) response containing a 2.1.1 Warnings object detailing the reasons why the caller may not want to go ahead with deletion.

Warning responses

The following warning situations are possible:

ID Response code Description
part_of_course 428 (Precondition Required) The drill is part of one or more courses
part_of_group 428 (Precondition Required) The drillable is part of one of the groups of which the caller is a member (foreign drillable), or the drillable is part of a group managed by the caller
test_completed 428 (Precondition Required) One or more tests were completed that contain this drill
test_defined 428 (Precondition Required) A test has been defined for the drillable

Error responses

The following error situations are possible:

ID Response code Description
drillable_id_missing 400 (Bad request) No drill or course ID specified
part_of_course 400 (Bad request) The specified drillable is part of a course
part_of_group 400 (Bad request) The specified drillable is part of a group
part_of_objective 400 (Bad request) The specified drillable is part of one or more objectives
test_defined 400 (Bad request) A test has been defined for this drillable
unknown_drillable_id 404 (Not found) The specified drillable is unknown

 

Last updated on