Skip to main content Skip to navigation

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