PUT test/…/drill/…

Updates the version of one of the test's drills to the most recently released version.

Resource URL

https://www.drillster.com/api/2.1.1/test/{test_id}/drill/{drill_id}

Parameters

Field Type Description
test_id
required
String The ID of the test definition. This defines the test itself, not the individual instances done by users.

Example value: 7OuHq7RcQOCsnGWR58TnBw
drill_id
required
String The key for one of the drills contained in the test definition for which the latest version should be used.

This is the unversioned key of the drill for which the latest version is to be used.

Response

A 2.1.1 Test object, with details about the test.

Error responses

The following error situations are possible:

ID Response code Description
test_id_missing 400 (Bad request) No test ID was specified
drill_id_missing 400 (Bad request) No drill ID was specified
unknown_test 404 (Not found) The specified test is unknown
no_permission 401 (Unauthorized) Caller does not have permission to retrieve this test
invalid_name 400 (Bad request) A blank test name was specified
invalid_drill_id 400 (Bad request) Not a valid drill ID
unknown_drill 400 (Bad request) Given drill is not part of the test
incompatible_version 400 (Bad request) Drill version is not compatible with the test. Reasons are specified in the error description. Possible reaons are:

  • no shared column
  • column not referenced
  • forced direction
  • questions count
  • no matching questions
already_latest_version 400 (Bad request) Referenced drill is already at the latest version