PUT course/…
Updates an existing course. Only the name, description and icon can be updated using this endpoint. For adding or changing the drills contained in the course the PUT course/…/…/… endpoint may be used.
Resource URL
https://www.drillster.com/api/2.1.1/course/{course_id}
Parameters
| Field | Type | Description |
|---|---|---|
course_idrequired |
String | The unique ID for the course. |
iconKeyoptional |
String | The reference to an icon that was uploaded earlier. |
coverKeyoptional |
String | The reference to a cover image that was uploaded earlier. |
nameoptional |
String | The name of the course. |
descriptionoptional |
String | The description of the course. |
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 Course object reflecting the changes.
Error responses
The following error situations are possible:
| ID | Response code | Description |
|---|---|---|
not_found |
404 (Not found) | Requested course was not found |
not_permitted |
403 (Forbidden) | Caller has no access to given group. |
icon_upload_failed |
500 (Internal error) | Something went wrong while uploading or processing the course icon. |