MODULE GUIDE · 11 OCT 2026

Examinations & results

Plan examinations and seating, record marks, review rechecks and publish report cards.

Try guided demo →Download guide ↓

OVERVIEW

What you can do

Exam schedules

Marks entry and history

Completion status

Grade scales

Report cards

Publish and unpublish

Seating and invigilation

Adaptive exams

Mark rechecks

BEFORE YOU BEGIN

Access & setup

Intended access: Assigned account with the required permissions.

An assigned school account with the required permissions.
The academic, student or staff setup used by this workflow.

Required permission keys

exam:viewexam:createexam:updateexam:deleteexam:manage

Use the public sample demo to learn this flow. Your assigned ERP account determines access to actual school records.

STEP BY STEP

How the workflow works

01
Create the exam and its subject schedules
An assigned school account with the required permissions.
02
Review the candidates, seating and completion status
Marks entry and history is part of the documented workflow.
03
Record and verify marks, then generate report cards
Completion status is part of the documented workflow.
04
Publish approved results; use the correction workflow when required
Review the result in the connected record or workspace before moving on.

Request fields to understand

Source-declared fields used by related operations; each operation has its own validation and scope.

Field	Declared type	Input
`title`	string	Required by declaration
`subjectId`	string	Required by declaration
`classId`	string	Required by declaration
`sectionId`	string	Optional
`targetCount`	number	Optional
`durationMin`	number	Optional
`maxAttempts`	number	Optional
`questionIds`	string[]	Optional
`publishResults`	boolean	Optional
`text`	string	Required by declaration
`options`	string[]	Required by declaration
`correctAnswer`	string	Required by declaration
`difficulty`	string	Optional
`chapter`	string	Optional
`marks`	number	Optional
`status`	string	Optional
`name`	string	Required by declaration
`rows`	number	Optional
`seatsPerRow`	number	Optional
`blockedSeats`	number	Optional
`building`	string	Optional
`floor`	string	Optional
`isActive`	boolean	Optional
`scheduleId`	string	Required by declaration

CURRENT BEHAVIOUR

Rules & current limits

Published results are distinct from draft marks. Adaptive question attempts and paper rechecks have separate workflows.

Source inventory checked on 11 October 2026. Guide availability confirms documentation publication, not certification of every external service or device flow.

LEARN BY DOING

Try examinations & results

Open a guided sample workspace, try the available actions, then reset whenever you like. No login required.

Launch guided demo →

FOR IMPLEMENTERS

API & permissions reference

This is the module’s source-declared endpoint catalogue. Reading this reference does not execute any request.

42 source-declared operations

GET/api/v1/adaptive-exams

List

exam:view

POST/api/v1/adaptive-exams

Create

exam:create

Declared request fields: title (required), subjectId (required), classId (optional), sectionId (optional), targetCount (optional), durationMin (optional), maxAttempts (optional), questionIds (optional), publishResults (optional).

GET/api/v1/adaptive-exams/questions

List Questions

exam:view

POST/api/v1/adaptive-exams/questions

Create Question

exam:create

Declared request fields: subjectId (required), text (required), options (required), correctAnswer (required), difficulty (optional), chapter (optional), marks (optional).

GET/api/v1/adaptive-exams/attempts/:attemptId

Attempt Detail

exam:view

GET/api/v1/adaptive-exams/:examId

Get Exam

exam:view

PATCH/api/v1/adaptive-exams/:examId/status

Update Status

exam:update

Declared request fields: status (required).

GET/api/v1/exam-seating/rooms

List Rooms

exam:view

POST/api/v1/exam-seating/rooms

Create Room

exam:create

Declared request fields: name (required), rows (optional), seatsPerRow (optional), blockedSeats (optional), building (optional), floor (optional).

PATCH/api/v1/exam-seating/rooms/:id

Update Room

exam:update

Declared request fields: isActive (optional).

DELETE/api/v1/exam-seating/rooms/:id

Remove Room

exam:delete

POST/api/v1/exam-seating/allocate

Seat every candidate for one paper

exam:manage

Declared request fields: scheduleId (required), roomIds (optional), replace (optional).

DELETE/api/v1/exam-seating/schedules/:scheduleId/seats

Clear

exam:manage

GET/api/v1/exam-seating/schedules/:scheduleId/plan

Room-by-room seating chart for a paper

exam:view

POST/api/v1/exam-seating/invigilators

Assign Invigilator

exam:update

Declared request fields: scheduleId (required), roomId (required), staffId (required), role (optional).

DELETE/api/v1/exam-seating/invigilators/:id

Remove Invigilator

exam:update

GET/api/v1/exam-seating/invigilators/staff/:staffId

One staff member's invigilation duty chart

exam:view

GET/api/v1/exam-seating/admit-card/:examId/:studentId

A candidate's papers with room and seat

exam:view

GET/api/v1/exams

List

exam:view

POST/api/v1/exams

Create

exam:create

Declared request fields: name (required), examType (optional), sessionId (optional), termId (optional), startDate (optional), endDate (optional).

PATCH/api/v1/exams/:id

Update

exam:update

Declared request fields: status (optional).

DELETE/api/v1/exams/:id

Remove

exam:delete

GET/api/v1/exams/:examId/schedules

List Schedules

exam:view

GET/api/v1/exams/:examId/completion

Completion

exam:view

POST/api/v1/exams/:examId/schedules

Create Schedule

exam:update

Declared request fields: classId (required), sectionId (optional), subjectId (required), examDate (optional), startTime (optional), endTime (optional), maxMarks (required), passMarks (optional), roomNo (optional).

POST/api/v1/exams/:examId/report-cards/generate

Compute report cards for a section in this exam

exam:update

GET/api/v1/exams/:examId/report-cards

Report Cards

exam:view

POST/api/v1/exams/:examId/report-cards/publish

Publish report cards to the parent/student portal

exam:manage

POST/api/v1/exams/:examId/report-cards/unpublish

Withdraw published results to issue a correction

exam:manage

Declared request fields: reason (required).

PATCH/api/v1/exam-schedules/:id

Update

exam:update

DELETE/api/v1/exam-schedules/:id

Remove

exam:delete

GET/api/v1/exam-schedules/:id/marks

Marks-entry roster for a schedule

exam:view

GET/api/v1/exam-schedules/:id/marks/history

History

exam:view

POST/api/v1/exam-schedules/:id/marks

Save Marks

exam:update

Declared request fields: version (optional), correctionReason (optional), records (required).

GET/api/v1/grade-scales

List

exam:view

POST/api/v1/grade-scales

Create

exam:update

Declared request fields: name (required), isDefault (optional), bands (required).

DELETE/api/v1/grade-scales/:id

Remove

exam:delete

GET/api/v1/report-cards/:id

Get

exam:view

GET/api/v1/mark-rechecks

List

exam:view

POST/api/v1/mark-rechecks

Query a published mark

Authenticated scope and endpoint-specific rules

Declared request fields: examScheduleId (required), studentId (required), reason (required).

POST/api/v1/mark-rechecks/:id/review

Acknowledge that the paper is being re-read

exam:manage

POST/api/v1/mark-rechecks/:id/decision

Uphold, revise or reject a recheck

exam:manage

Declared request fields: outcome (required), revisedMarks (optional), notes (optional).

Open the actual application

ERP links use your assigned account. Record-specific pages start from the list so you can choose a real record.

/en/school/adaptive-exams/attempts/[id]Open ↗/en/school/adaptive-examsOpen ↗/en/school/exam-seatingOpen ↗/en/school/examsOpen ↗/en/school/exams/[id]Open ↗/en/school/mark-rechecksOpen ↗

Examinations & results

What you can do

Exam schedules

Marks entry and history

Completion status

Grade scales

Report cards

Publish and unpublish

Seating and invigilation

Adaptive exams

Mark rechecks

Access & setup

How the workflow works

Create the exam and its subject schedules

Review the candidates, seating and completion status

Record and verify marks, then generate report cards

Publish approved results; use the correction workflow when required

Request fields to understand

Rules & current limits

Try examinations & results

API & permissions reference

Open the actual application

Keep exploring