Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Saurabh-07586/examplatform/llms.txt

Use this file to discover all available pages before exploring further.

Every exam in ExamPlatform moves through a well-defined series of stages — from the moment an examiner opens a blank draft all the way to students downloading their result PDFs. Understanding this lifecycle helps examiners plan their assessments effectively, helps administrators track platform activity, and gives students clarity on when and how they can access their scores. Each stage carries a distinct status that is visible on the Exam Management dashboard and on the student’s Exam Schedule.
1

Draft

The examiner creates a new exam draft by filling in the core details: exam title, subject, start time, end time, duration in minutes, total number of questions, an optional passing percentage, and any exam-specific instructions for students. At this stage the examiner also configures the evaluation workflow — choosing whether to enable AI evaluation for subjective answers, whether to allow manual examiner review, and whether subjective responses should be routed to manual review after an AI first-pass. The exam is saved as a draft and is not yet visible to students.
2

Question Selection

With the draft saved, the examiner selects questions from the question bank. Questions are filtered by the subject set on the exam so that only relevant items appear. Critically, only active questions are available for selection — any question that has been deactivated is excluded from the list automatically. The examiner can select individual questions or use Select All for the filtered set. Only the selected questions will be included when the exam is delivered to students.
3

Student Assignment

The examiner assigns the specific students who are eligible to sit this exam. The student search panel supports lookup by name, email address, or roll number, making it easy to find individuals in large cohorts. Assigned students will see the exam appear in their Exam Schedule and will receive reminder notifications. Students who are not assigned cannot access the exam.
4

Published / Scheduled

Once the exam is ready, the examiner or an administrator publishes it. The exam status transitions from Draft to Upcoming, indicating that the exam is scheduled and visible to assigned students but the start window has not yet opened. Students see the exam in their schedule with its start time, duration, total marks, and the examiner’s name.
5

Live

When the start time is reached and students begin their sessions, the exam enters the Live state. The Live Monitoring dashboard — accessible to examiners and administrators — refreshes automatically every 10 seconds and shows each active session’s current question, time remaining, tab switch count, AI risk score, and last heartbeat timestamp. Administrators can issue a Force Submit against any individual session directly from this panel.
6

Completed

The exam transitions to Completed once all sessions have ended — either through student submission, automatic server-side submission when time expires, or admin-initiated force submit. At this point, objective answers have already been auto-graded. Subjective answers (short answer, long answer, image upload) are waiting in the evaluation queue for grading.
7

Graded

All answers have been evaluated. Objective questions (MCQ and multi-select) were graded automatically against the answer key at the moment of submission. Subjective questions have been reviewed by the examiner — with or without an AI first-pass suggestion — and a final grade has been submitted for every response. The exam is now ready for results to be published.
8

Results Published

The examiner or administrator clicks Publish Results, making scores visible to students. Each student can view their marks obtained, percentage, correct and incorrect answer counts, rank among all participants, and pass/fail status. Students can also download their individual result as a PDF. Examiners and administrators can download full exam reports in PDF, Excel, or CSV format.

Exam Statuses

ExamPlatform uses six distinct status values to represent where an exam is in its lifecycle. These statuses appear on the Exam Management list, the admin dashboard’s exam status breakdown widget, and on the student’s Exam Schedule.
StatusDescription
DraftThe exam has been created but not yet published. It is only visible to the examiner who created it and to administrators. Students cannot see it.
UpcomingThe exam has been published and is scheduled for a future start time. Assigned students can see it in their Exam Schedule under “Not yet open.”
ActiveThe exam’s start window has opened and students are able to begin their sessions. The system accepts new session starts during this window.
LiveOne or more student sessions are currently in progress. The Live Monitoring dashboard is active and refreshing in real time.
CompletedAll sessions have ended. The exam is closed to new entries. Subjective answers are pending grading; objective answers are already scored.
PublishedResults have been published by the examiner or administrator. Students can view scores, rankings, and download PDFs. The exam is fully closed.
The exam timer is server-controlled and cannot be paused or manipulated by the student. When the allotted duration expires, the platform automatically submits the student’s session — including all answers saved up to that point — regardless of whether the student has clicked the Submit button. Students see a confirmation screen stating “Your time expired and the exam was automatically submitted.”
Negative marking is configured per-question and applies to MCQ (single correct) and multi-select question types. When negative marking is enabled on a question, an incorrect answer deducts the configured negative marks value from the student’s score. Questions with no negative marking value set award zero for an incorrect answer. Negative marking settings are defined when creating or editing a question in the question bank and are applied automatically at the point of auto-grading on submission.

Build docs developers (and LLMs) love