== Overview ==

This is the first version of API. The main purpose of this version of API is to provide a way for external applications, e.g., learning management system, to interact with iPeer with tighter integration and better user experience. Data returned will be in JSON format with XML support coming later.

== Authentication ==
OAuth 2.0

== Resources ==

=== Users ===

||GET||/v1/users||get a list of users||
||GET||/v1/users/{id}||get a user with id||
||POST||/v1/users||create a user/users||
||DELETE||/v1/users/{id}||remove a user with id||
||PUT||/v1/users/{id}||update a user with id||

=== Courses ===

||GET||/v1/courses||get a list of courses for current logged in user||
||GET||/v1/courses/{id}||get a course with id||
||POST||/v1/courses||create a course||
||DELETE||/v1/courses/{id}||remove a course with id||
||PUT||/v1/courses/{id}||update a course with id||

=== Groups ===

||GET||/v1/courses/{course_id}/groups||get a list of groups in course {course_id}||
||GET||/v1/courses/{course_id}/groups/id||get a group in course {course_id}||
||POST||/v1/courses{course_id}/groups||create a group in course {course_id}||
||DELETE||/v1/courses/{course_id}/groups/{id}||remove a group  in course {course_id}||
||PUT||/v1/courses/{course_id}/groups/{id}||update a group in course {course_id}||

=== Grades ===

||GET||/v1/courses/{course_id}/grades||get a list of grades in course {course_id}||
||GET||/v1/courses/{course_id}/grades/id||get a grades in course {course_id}||

* Grades are read-only