PUT rendition/…/preferences

Updates the calling user's practice preferences for the given drillable.

Only attributes that are user configurable can be updated. Attempting to update attributes that are not user configurable will cause an error.

Resource URL

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

Parameters

Field Type Description
drillable_id
required
String Unique identifier of the drill or course.

Example value: 5YiBVXMMkIB6FmcLssQ74Q
direction
optional
String constant The user's preferred practice direction for the drillable:

  • BIDIRECTIONAL
  • PRODUCTIVE
  • RECEPTIVE
If this attribute is not given, the stored value is not changed.
style
optional
String constant The user's preferred practice style for the drillable:

  • MULTIPLE_CHOICE
  • OPEN_ENDED
If this attribute is not given, the stored value is not changed.
unknownColumns
optional, repeatable
String The names of the unknown columns to include. This parameter can be specified multiple times to include more than one unknown column.

If no columns are given, the stored set if left unchanged. Specifying an empty set is not possible.
useIntroductions
optional
Boolean Specifies whether the calling user wants to see introductions for this drillable.
autoAdvancement
optional
Boolean Specifies whether the calling user wants to advance to the next question automatically where appropriate.

If a PUT request has no body (i.e. the body is empty), it is still mandatory to include a Content-Length header (i.e. Content-Length: 0). Not all HTTP clients do this automatically. For more information, please see RFC 2616.

Response

A 2.1.1 Preferences object containing the practice preferences.