Skip to main content
POST

Authorizations

X-API-Key
string
header
required

Your institute's API key, vak_eval_ followed by 48 hex characters. An institute admin creates keys in the dashboard under Settings -> Integrations -> API keys.

Headers

Idempotency-Key
string

Optional. Any unique string of 1-255 printable ASCII characters (a UUID works). Retrying with the same key within 48 hours replays the first response with Idempotent-Replayed: true.

Maximum string length: 255
Example:

"exam-cbse-sci-10a-2026-10-14"

Path Parameters

examId
string<uuid>
required

Exam id (UUID).

Body

application/json
submission_ids
string[]

Up to 500 submission ids. Send this or all_graded.

all_graded
boolean

Finalize every graded, unfinalized submission of the exam (up to 500 per call).

allow_partial
boolean

Also finalize partially_graded and failed submissions; failed questions count 0.

Response

OK

finalized
string[]

Submission ids finalized by this call.

skipped
object[]
has_more
boolean

With all_graded, true when more than 500 were eligible: call again.