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}/marksEvaluate 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
The submission to grade.
Body
JSONStringMarks awarded, before any late penalty. Can't be more than the assignment's maximum marks. Default 0.
faculty_commentsstring
Tutor feedback (HTML allowed). Replaces any earlier comment.
The assignment. With
class_id, used to decide whether this is the student's first passing attempt.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.
passedis 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.