Retrieve a small group set
Returns a small group set object if a valid identifier was provided. When requesting the ID of a small group set that has been deleted, a HTTP 404 Not Found
will be returned.
Permission requirements
The user must have Permissions.SmallGroups.Read
("View small groups") on the small group set. By default, roles that have this permission are:
- Module Auditor
- Module Assistant
- Module Manager
- Departmental Administrator
- User Access Manager
Information about API permissions
Definition
GET https://tabula.warwick.ac.uk/api/v1/module/:moduleCode/groups/:smallGroupSetId
URL substitution variables
:moduleCode |
The lowercase form of the module code for the module containing the small group set, e.g. ch225 |
---|---|
:smallGroupSetId |
The unique identifier for the small group set |
Example request
GET https://tabula.warwick.ac.uk/api/v1/module/cs118/groups/2552f556-6210-4de7-bb8e-01a3180f619e
Response parameters
An unsuccessful response will be returned in the standard format. A successful response will return the HTTP code 200 OK
and the following parameters:
success |
Boolean true |
---|---|
status |
The string "ok" |
academicYear |
The string in the format yy/yy"15/16" |
groupSet |
A small group set object representing the small group set |
Example response
{
"success": true,
"status": "ok",
"academicYear": "15/16",
"groupSet": {
"id": "2552f556-6210-4de7-bb8e-01a3180f629e",
"archived": false,
"name": "MySmallGroupSet-01-tutorial",
"allocationMethod": "StudentSignUp",
"format": "tutorial",
"openForSignups": false,
"releasedToTutors": false,
"releasedToStudents": false,
"collectAttendance": true,
"studentsCanSeeTutorName": true,
"studentsCanSeeOtherMembers": false,
"emailStudentsOnChange": true,
"emailTutorsOnChange": true,
"groups": [],
"allowSelfGroupSwitching": false,
"sitsLinks": [
{
"moduleCode": "CH155-24",
"assessmentGroup": "A2",
"occurrence": "A",
"sequence": "A05"
},
{
"moduleCode": "CH155-36",
"assessmentGroup": "A2",
"occurrence": "A",
"sequence": "A08"
}
],
"studentMembership": {
"total": 5,
"linkedSits": 5,
"included": 0,
"excluded": 0,
"users": [
{
"userId": "xxxxxa",
"universityId": "1111111"
},
{
"userId": "xxxxxb",
"universityId": "2111111"
},
{
"userId": "xxxxxc",
"universityId": "3111111"
},
{
"userId": "xxxxxd",
"universityId": "4111111"
},
{
"userId": "xxxxxe",
"universityId": "5111111"
}
]
}
}
}
Tabula API Methods
- Overview
- The Member object
- The StudentCourseDetails object
- The StudentCourseYearDetails object
- The StudentRelationship object
- The Student RelationshipType object
- The ModuleRegistration object
- Retrieve a member
- Retrieve multiple members
- Retrieve a member's relationships
- List relationship agents in dept.
- Search for members