Skip to main content
POST
Publish exam results
Step 7 of 8 in Evaluate an exam.

Rules

  • entity is required and takes one of two values.
  • Publishing applies to the whole exam, not to one answer sheet. Every student’s score becomes readable at once.
  • Publishing twice is harmless. The first call’s timestamp is kept.
Review the scores before you publish. Once the provisional result is out, students can read every deduction. Editing a question or a model answer is already locked by this point, though a teacher can still change an answer’s marks.

Next step

Get provisional exam scores

Show a student their provisional result.

Authorizations

Authorization
string
header
required

Access token from Get an access token. A missing, invalid, or expired token returns 403.

Path Parameters

examId
string<uuid>
required

The exam id returned by Create an exam.

Example:

"d19e6868-98dd-4274-a2a5-4a616dd93ea7"

Body

application/json
entity
enum<string>
required

pre-publish for the provisional result, final-publish for the final result.

Available options:
pre-publish,
final-publish

Response

The result is published. It applies to every answer sheet in the exam.

message
string