Examinations
Revaluation and results
Marking workflow, moderation, result publication and revoke, and revaluation requests.
Examinations guide for day and boarding schools.
Last updated August 29, 2026
After exam day, markers enter scores per paper (My marking tasks or Grades). Marks can be frozen per paper. Publishing session results builds session grade cards, freezes any remaining published-paper marks, notifies families, and opens the revaluation window when appealsOpenUntil is set. Revoke hides results from families without deleting grade-card history.
Revaluation is a controlled correction to one student’s mark on one paper, not a second exam session. A student or linked parent can file after the session result is PUBLISHED; if appealsOpenUntil is set, the request must arrive before that timestamp. The request keeps the original mark, reason and requester, and the unique paper-plus-student key prevents more than one active request. Coordinators review the queue at /exam-revaluation and record a closing decision, revised mark or reviewer notes.
A COMPLETED_REVISED decision validates the new value against the paper maximum, updates the linked AssessmentMark and writes a marks audit entry. The session grade cards are then rebuilt asynchronously so the revised value can flow into the formal session result. A request cannot be changed after the session is archive-frozen. Revoke and republish are separate chair-gated actions on committee-governed sessions; without a committee, the coordinator gate remains in effect. Neither action deletes retained grade-card rows.
Publish results gates
- Committee chair (on committee-governed sessions); archive-frozen sessions cannot publish or revoke
- At least one PUBLISHED paper in the session
- Marks completeness - missing student marks block publish unless acknowledged incomplete
- Optional class-teacher sign-off - all required classes must acknowledge on /my-class/exams
- Republish requires an explicit republish flag when already PUBLISHED
- /exam-papers/my-marking-tasks - marker data entry per paper
- Session detail - freeze marks, sign-off matrix, publish/revoke results
- /exam-revaluation - staff process student revaluation requests
- Students request revaluation from /my-exams after results are published (within appeals window); a linked parent may file for a child provided they name the student, and submissions are capped at five a day per account
- Revaluation is the only supported route that writes through a mark freeze - an approved revised mark updates the frozen assessment row and records the before and after values in the marks audit trail
- Session grade cards - distinct from term report cards at /grades/report-cards
- /my-exams and /parent-dashboard/exams - family view of published marks and grade cards only
Common questions
Quick answers in plain language.
Can a student request revaluation before results are published?+
No. The paper’s session must have resultPublicationStatus PUBLISHED, and the appeals window must still be open when appealsOpenUntil is configured. The API also requires an existing assessment-mark row for that student and paper.
What happens after a revised mark is approved?+
The coordinator’s COMPLETED_REVISED decision updates the linked AssessmentMark after validating the paper maximum, records the before-and-after values in the marks audit trail, and starts an idempotent session grade-card rebuild. The student and parent are notified of the status change.
Can the same student file a second active request for one paper?+
No. The paper-and-student pair is unique while an existing request is active. A request that is cancelled or rejected can be submitted again; an unresolved or completed active request must be handled through the coordinator workflow instead.
Related searches
School leaders and IT teams often search for: how to revaluation in school management software, best exam management software for K-12 schools, Schoolyi revaluation guide, online exam scheduling schools, hall ticket software, and school results portal.

