PUT drillable/…/review

Posts a review of a given public drillable.

Resource URL

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

Parameters

Field	Type	Description
`drillable_id` required	String	The ID of the drill or course to retrieve the reviews for. Example value: `eSxMA4MISaCjJA43PgMEnQ`
`content` required	String	The actual review message text.
`appreciation` optional	Integer	An optional appreciation rating in the 1..5 range.

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 Review object reflecting the review that was just added.

Example request

POST https://www.drillster.com/api/2.1/drillable/eSxMA4MISaCjJA43PgMEnQ/review
content=I+found+this+drill+to+be+very+useful!

Response

{
  "timestamp": "2015-06-12T07:16:23Z",
  "reviewer": {
    "type": "USER",
    "id": "m3XfGV1LQhu729lfVYa_sQ",
    "name": "Jane Doe"
  },
  "content": "I found this drill to be very useful!"
}

Error responses

The following error situations are possible:

ID	Response code	Description
`missing_drillable_id`	400 (Bad request)	No drillable ID was supplied
`missing_message`	400 (Bad request)	No message was supplied
`not_in_repertoire`	403 (Forbidden)	User's repertoire does not contain given drillable

Last updated on 2025-04-18