Update a small group set

Edit a small group set's properties.

Permission requirements

The user must have Permissions.SmallGroups.Update ("Edit small groups") on the small group set that will be edited. By default, roles that have this permission are:

• Module Assistant
• Module Manager
• Departmental Administrator
• User Access Manager

Information about API permissions

Definition

PUT https://tabula.warwick.ac.uk/api/v1/module/:moduleCode/groups/:smallGroupSetId

The request Content-Type must be set to application/json

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

Request parameters

name Optional	A name for the small group set. Name provided should be less than 200 chars
format Optional	The small groups format, one of: seminar - Seminar lab - Lab tutorial - Tutorial project - Project group example - Example Class workshop - Workshop lecture - Lecture meeting - Meeting exam - Exam
allocationMethod Optional	The method for allocating students to groups, one of: Manual - Students are manually allocated to groups by an administrator StudentSignUp - Students sign up to an available group Linked - Student membership is linked to allocation from a linked department small group set Random - Students are randomly allocated to groups
studentsCanSeeTutorName Optional	A boolean value, set to trueif students are allowed to see the name of the event tutor(s), false otherwise
studentsCanSeeOtherMembers Optional	A boolean value, set to true if students are allowed to see the details of students in the same group, false otherwise
collectAttendance Optional	A boolean value, set to true if attendance is collected at events, false otherwise
allowSelfGroupSwitching Optional	A boolean value, set to true if students are allowed to switch groups until sign-up is closed, false otherwise

Example request

{
  "name": "MySmallGroupSet-01-tutorial",
  "format": "tutorial"
}

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"
        }
      ]
    }
  }
}