DELETE drillable
Deletes a drill or course.
Resource URL
https://www.drillster.com/api/2.1.1/drillable/{drillable_id}
Parameters
| Field | Type | Description |
|---|---|---|
drillable_idrequired |
String | The ID of the drillable to be deleted. Example value: 9YMJPGVci_R_iyqeh3SLO9 |
ignoreWarningsoptional |
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 |