Coronavirus (Covid-19): Latest updates and information
Skip to main content Skip to navigation

Upload marks for an assignment

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

Tabula API Methods