Skip to main content Skip to navigation

Submit an assignment to Turnitin

Submits all submissions on an assignment that haven't already been checked by Turnitin to Turnitin for plagiarism checking.

Permission requirements

The user must have Permissions.Submission.CheckForPlagiarism ("Check a coursework submission for plagiarism") on the assignment. 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/turnitin

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

URL substitution variables

:moduleCode The lowercase form of the module code for module to create the assignment in, e.g. cs118
:assignmentId The unique identifier for the assignment

Request parameters

submitter Optional The ITS usercode of the user submitting the report - this is used for generating an appropriate login to the Turnitin service

Example request

{
  "submitter": "cuscav"
}

Response parameters

An unsuccessful response will be returned in the standard format. A successful response will return the HTTP code 202 Accepted. The Location header will be the API endpoint of the asynchronous job that has been created to submit the papers to Turnitin, and the JSON metadata of the created job, with the following parameters:

success Boolean true
status The string "ok"
job A job instance object representing the job

Example response

{
  "success": true,
  "status": "ok",
  "job": {
    "finished": false,
    "data": {
      "assignment": "94647a17-0aec-496b-b552-4b9390e8da63"
    },
    "jobType": "turnitin-submit-lti",
    "id": "523ce002-e63d-4205-9457-88c060daec09",
    "successful": false,
    "progress": 0,
    "status": null,
    "started": false,
    "updatedDate": "2015-11-10T15:59:26Z",
    "user": "in-matmannion-tabula-api",
    "createdDate": "2015-11-10T15:59:26Z"
  }
}

Tabula API Methods