POST courses

POST Creates a new course. A course is a collection of drills held together with a single title, icon and description.

The created course will be empty. The assigned course ID is returned in the response.

Resource URL

https://www.drillster.com/api/2/courses

Parameters

Field Description
name
required

The name of the newly created course.

Example value: French Made Easy

description
required

A description of the course. The description is used to tell users about the course to help them decide whether the course is appropriate for them.

Example value: Contains the idiom list from chapters 1 through 12 of the book French Made Easy.

Response

The ID of the created course.

Example request

POST https://www.drillster.com/api/2/courses
name=French+Made+Easy
description=Contains+the+idiom+list+from+chapter+1+through+12+of+the+book+French+Made+Easy.

Response

{
  "id" : "R_GVlYZQTKOEmN_r69EVFQ",
  "type" : "COURSE"
}

The type is used to differentiate drills from courses, and will be set to COURSE in all cases for this API call.

Error responses

The following error situations are possible:

ID Description
no_input No input received
name_missing No drill name specified
description_missing No drill description specified