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 |