Edit's an assignment's properties.

Permission requirements

The user must have Permissions.Assignment.Update ("Edit an assignment") on the assignment 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/assignments/:assignmentId

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 assignment, e.g. cs118
:assignmentId	The unique identifier for the assignment

Request parameters

name	A name for the assignment, must be unique amongst non-archived assignments
openDate Optional	The date that the assignment is open for submission, in ISO date format
closeDate Optional	The date that the assignment closes, in ISO date format. closeDate is Required unless openEnded is true
openEnded Optional	A boolean value, set to true if the assignment never closes after it's been opened. Default: false
collectMarks Optional	A boolean value for whether the assignment should collect marks. If not, no mark or grade options will be available. Default: true
markingWorkflow Optional	The unique ID of a marking workflow to use for this assignment. The workflow must be created in the Department
feedbackTemplate Optional	The unique ID of a feedback template to use for this assignment. The template must be created in the Department
summative Optional	A boolean value, set to true if the assignment is credit-bearing (summative), false otherwise (formative). Formative assignments are not considered in 20-day feedback turnaround reports. Default: true
dissertation Optional	A boolean value, set to true if the assignment is a dissertation. Dissertations are not considered in 20-day feedback turnaround reports. Default: false
collectSubmissions Optional	A boolean value for whether the assignment should collect submissions. If not, no submission options will be available. Default: true
displayPlagiarismNotice Optional	true if the plagiarism notice should be displayed to students when submitting, false otherwise Default: true
restrictSubmissions Optional	true if only students who are in the student membership should be allowed to submit, false otherwise (anyone with the URL can submit) Default: false
allowLateSubmissions Optional	true if late submission should be allowed for students who have not previously submitted, false otherwise Default: true
allowResubmission Optional	true if students shoule be allowed to resubmit up to the deadline, false otherwise Default: true
allowExtensions Optional	true if students should be allowed to request extensions (and the Department allows it), false otherwise Default: true
fileAttachmentLimit Optional	An Integer for the maximum number of attachments a student can submit. Must be 1 or more. Default: 1
fileAttachmentTypes Optional	An array of strings containing file extensions that students are allowed to submit. If empty, students can submit any file Default: []
submissionFormText Optional	Text displayed to students when submitting Default: ""
wordCountMin Optional	The minimum word count a student must declare to be able to submit, or null if word counts aren't required or there is no lower limit Default: null
wordCountMax Optional	The maximum word count a student must declare to be able to submit, or null if word counts aren't required or there is no upper limit Default: null
wordCountConventions Optional	Text displayed to student when they submit their word count Default: "Exclude any bibliography or appendices."
includeUsers Optional	Array of student university IDs or usercodes who should be manually enrolled on the assignment. This will overwrite the existing list of included users. This can be used to add users beyond those included from a SITS assignment component link.
excludeUsers Optional ⋅ Since 2020.1.2	Array of student university IDs or usercodes who should be manually excluded from the assignment. This will overwrite the existing list of excluded users. This can be used to remove users who would otherwise be included from a SITS assignment component link.

Example request

{
  "name": "My assignment",
  "openDate": "2013-11-05",
  "closeDate": "2014-01-27",
  "includeUsers": [
    "1673473"
  ]
}

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"
assignment	An assignment object representing the assignment
genericFeedback	The generic feedback for the assignment, as a string, if set
students	An array of assignment student objects representing the students' submissions and feedback

Example response

{
  "success": true,
  "status": "ok",
  "assignment": {
    "id": "2552f556-6210-4de7-bb8e-01a3180f609e",
    "archived": false,
    "academicYear": "13/14",
    "name": "Coursework",
    "studentUrl": "https://tabula.warwick.ac.uk/coursework/module/es173/2552f556-6210-4de7-bb8e-01a3180f609e/",
    "collectMarks": true,
    "markingWorkflow": null,
    "feedbackTemplate": null,
    "summative": true,
    "dissertation": false,
    "collectSubmissions": true,
    "displayPlagiarismNotice": false,
    "restrictSubmissions": true,
    "allowLateSubmissions": true,
    "allowResubmission": true,
    "allowExtensions": true,
    "fileAttachmentLimit": 1,
    "fileAttachmentTypes": [],
    "submissionFormText": "Submit this",
    "wordCountMin": null,
    "wordCountMax": null,
    "wordCountConventions": "",
    "submissions": 1,
    "unapprovedExtensions": 0,
    "studentMembership": {
      "total": 8,
      "linkedSits": 0,
      "included": 8,
      "excluded": 0
    },
    "sitsLinks": [],
    "openEnded": false,
    "opened": true,
    "closed": true,
    "openDate": "2013-11-05T00:00:00Z",
    "closeDate": "2014-01-27T10:00:00Z",
    "feedbackDeadline": "2014-02-24",
    "feedback": 1,
    "unpublishedFeedback": 1
  }
}