Uploads marks and feedback for an assignment. This API endpoint has the same behaviour as the web form for uploading marks.

Permission requirements

The user must have Permissions.AssignmentFeedback.Manage ("Manage feedback") on the assignment for which marks will be uploaded. By default, roles that have this permission are:

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

Information about API permissions

Definition

POST https://tabula.warwick.ac.uk/api/v1/module/:moduleCode/assignments/:assignmentId/marks

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. cs141
:assignmentId	The unique identifier for the assignment

Request parameters

The body of the request must consist of a JSON object with a single key named "students" whose value is a list of feedback objects with the following keys:

id	The 7-digit university ID of the student the feedback is for, e.g. 1234567.
mark Optional	The mark for this student, which must be a numeric value in the range of 0-100.
grade Optional	The grade for this student, e.g. if using a different mark scale.
feedback Optional	Any written feedback for the student. The feedback may contain markdown.

Example request

{
  "students": [
    {
      "id": "1234567",
      "mark": "73",
      "grade": null,
      "feedback": "*Good* work!",
    },
    {
      "id": "1234568",
      "mark": "41",
      "grade": null,
      "feedback": "Could be better!",
    },
    {
      "id": "1234569",
      "mark": null,
      "grade": "20",
      "feedback": "_Outstanding_ work!",
    }
  ]
}

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"

Example response

{
  "success": true,
  "status": "ok"
}