Docs home

Evaluate Assignment and Update Marks

Grades a student's assignment submission: saves the marks and tutor comments, and optionally attaches a feedback file. Put the attempt ID (`attempt_id` from "Exercise Attempt List") in the URL. The grade, pass/fail and any late-submission penalty are worked out from the marks.

POST/assignment/attempt/{attempt_id}/marks
Evaluate Assignment and Update Marks
curl --request POST \
  --url 'https://<your-api-host>/nuSource/api/v1/assignment/attempt/{attempt_id}/marks' \
  --header 'APIKEY: <your-api-key>' \
  --header 'ORGID: <your-org-id>' \
  --form 'JSONString={"exercise_id":73182,"exercise_name":"asfdcasdf","test_parts":[],"class_id":135638,"user_test_time":0,"mark":"13","faculty_comments":"<p>Good work</p>"}'

Access: Institute admins and tutors, plus custom roles that can manage submissions.

Request body: form-data with a JSONString field holding the JSON below, plus an optional file field.

Path parameters
attempt_idintegerrequired
The submission to grade.
BodyJSONString
marknumberrequired
Marks awarded, before any late penalty. Can't be more than the assignment's maximum marks. Default 0.
Tutor feedback (HTML allowed). Replaces any earlier comment.
exercise_idintegerRecommended
The assignment. With class_id, used to decide whether this is the student's first passing attempt.
class_idintegerRecommended
The class (subject batch) of the attempt.
Only for institutes using the Woolf integration: sends the grade there.
Only for institutes using the Woolf integration: sends the feedback there.
file_1file
Feedback file for the student, up to 200 MB. PDF, text, Word, Excel, ZIP, RAR, JPEG or PNG.

Response: mark (final marks after any late penalty), evaluated_mark (marks you gave), late_penalty_marks, certificate_generated (true if this grading completed the course and a certificate was issued), and late-submission details for display.

Notes:

  • The attempt is marked as final. passed is set if the grade (percent) reaches the assignment's passing mark.
  • On the first passing attempt in a class, course completion is checked, which can issue a certificate and send completion notifications and webhooks. An "exercise evaluated" webhook is sent if your institute has one.
  • If results are visible to students, the student is notified.
  • Fails with "Marks obtained cannot be more than total marks of test." Rate limit: 30 requests per minute; going over locks you out for 30 minutes.

Updated yesterday

Ask AI