Groups in courses
This section relates specifically to the relationship between groups and courses. Groups can be enrolled into a course either before or after a learner has been added to a group. If a learner is added to a group, they inherit the enrolment of any course the group is enrolled in.
GET /api/v1/courses/{course}/groups
Returns a list of all the groups enrolled in a specific course. The groups are returned sorted by creation date, with the most recently created groups appearing first. Filter groups using the query parameters listed in the table.
Path variables
Field | Description |
---|
course | Course ID |
Query parameters
Field | Type | Description | Required | Default | Pattern |
---|
owner | string | Owner User ID | No | null | \d+ |
search | string | Search by Group name | No | "" | N/A |
sort | string | Sort by | No | "created" | (alpha|recent|created) |
page | string | Which page of items to display, starting with zero | No | "0" | \d+ |
length | string | Items per page (0-100) | No | "10" | \d+ |
Responses
Code | Description |
---|
200 | Returned when successful |
POST /api/v1/courses/{course}/groups
Create a new group, and enrol it into a specific course.
Path variables
Field | Description |
---|
course | Course ID |
FormData properties
Field | Description | Required |
---|
name | Group Name | No |
Responses
Code | Description |
---|
201 | Returned when successful |
GET /api/v1/courses/{course}/groups/{group}
Get the details of a specific group enrolled in a specific course.
Path variables
Field | Description |
---|
course | Course ID |
group | Group ID |
Responses
Code | Description |
---|
200 | Returned when successful |
POST /api/v1/courses/{course}/groups/{group}/links
Enrol an existing group into an existing course.
Path variables
Field | Description |
---|
course | Course ID |
group | |
Query parameters
Field | Type | Description | Required | Default | Pattern |
---|
start | string | When this group should start the course | No | null | N/A |
end | string | When this group should finish the course | No | null | N/A |
Responses
Code | Description |
---|
200 | Returned when successful |
GET /api/v1/courses/{course}/groups/{group}/students
Returns a list of all of the learners enrolled into a specific course via a specific group.
Path variables
Field | Description |
---|
course | Course ID |
group | Group ID |
Query parameters
Field | Type | Description | Required | Default | Pattern |
---|
page | string | Which page of items to display, starting with zero | No | "0" | \d+ |
length | string | Items per page (0-100) | No | "10" | \d+ |
search | string | An input to search for | No | "" | N/A |
Responses
Code | Description |
---|
200 | Returned when successful |
GET /api/v1/courses/{course}/groups/{group}/teachers
Returns a list of all of the trainers enrolled into a specific course via a specific group.
Path variables
Field | Description |
---|
course | Course ID |
group | Group ID |
Query parameters
Field | Type | Description | Required | Default | Pattern |
---|
page | string | Which page of items to display, starting with zero | No | "0" | \d+ |
length | string | Items per page (0-100) | No | "10" | \d+ |
search | string | An input to search for | No | "" | N/A |
Responses
Code | Description |
---|
200 | Returned when successful |