{"openapi":"3.0.1","info":{"title":"Evalezy AI Evaluation API","description":"Create exams, register candidates, submit answer sheets or typed answers and read AI marks. Server-to-server only: never ship an API key inside a mobile or browser app. Hindi answers and language papers are not supported yet.","version":"v1"},"servers":[{"url":"https://api.evalezy.com/v1","description":"Public host"},{"url":"https://backend-stage.vacademy.io/assessment-service/open/evaluation/v1","description":"Same API on the platform host"}],"security":[{"ApiKey":[]}],"tags":[{"name":"Exams","description":"Exams, questions, rubrics and choice groups"},{"name":"Submissions","description":"Answer sheets and typed answers, results, review and finalize"},{"name":"Candidates","description":"Institute candidates and exam registration"},{"name":"Uploads and credits","description":"Presigned uploads for answer sheets; credit balance and quotes"}],"paths":{"/exams/{examId}/questions/{questionId}/rubric":{"put":{"tags":["Exams"],"summary":"Set or clear one question's rubric and/or model answer (If-Match: rubric version)","operationId":"putRubric","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"questionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonNode"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/exams/{examId}/choice-groups":{"put":{"tags":["Exams"],"summary":"Replace the exam's choice groups (internal choice)","operationId":"putChoiceGroups","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceChoiceGroups"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/uploads":{"post":{"tags":["Uploads and credits"],"summary":"Presigned PUT URLs for one or up to 100 PDFs (valid 1 hour)","operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUploads"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/submissions/{submissionId}/unfinalize":{"post":{"tags":["Submissions"],"summary":"Put a finalized result back on hold (reason required, audited)","operationId":"unfinalize","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unfinalize"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/submissions/{submissionId}/re-evaluate":{"post":{"tags":["Submissions"],"summary":"Grade the copy again (charged again); keep_reviewed keeps teacher-edited questions","operationId":"reevaluate","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Reevaluate"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/submissions/{submissionId}/cancel":{"post":{"tags":["Submissions"],"summary":"Cancel a queued or running evaluation (not billed)","operationId":"cancel","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/submissions/{submissionId}/approve":{"post":{"tags":["Submissions"],"summary":"Approve the AI marks as reviewed, without changes","operationId":"approve","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Approve"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/exams":{"get":{"tags":["Exams"],"summary":"List this institute's API exams","operationId":"listExams","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageExam"}}}}}},"post":{"tags":["Exams"],"summary":"Create an exam (questions, choice groups and candidates may be inline; open:true opens it)","operationId":"createExam","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExam"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/exams/{examId}/submissions":{"get":{"tags":["Submissions"],"summary":"An exam's submissions; include=result for full results (limit capped at 50)","operationId":"listForExam","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"needs_review","in":"query","required":false,"schema":{"type":"string"}},{"name":"finalized","in":"query","required":false,"schema":{"type":"string"}},{"name":"candidate_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"include","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageMapStringObject"}}}}}},"post":{"tags":["Submissions"],"summary":"Submit a handwritten copy (upload_id) or typed answers (answers[]) for a candidate","operationId":"create_1","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubmission"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/exams/{examId}/questions":{"get":{"tags":["Exams"],"summary":"List an exam's questions; include=rubric,model_answer","operationId":"listQuestions","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}},"post":{"tags":["Exams"],"summary":"Add questions to a draft exam","operationId":"addQuestions","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddQuestions"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/exams/{examId}/open":{"post":{"tags":["Exams"],"summary":"Open a draft exam for submissions","operationId":"openExam","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/exams/{examId}/finalize":{"post":{"tags":["Submissions"],"summary":"Finalize graded submissions (no emails, PDFs or workflow events)","operationId":"finalizeExam","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Finalize"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/exams/{examId}/candidates":{"get":{"tags":["Candidates"],"summary":"Candidates registered on an exam, with their latest submission","operationId":"listForExam_1","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageMapStringObject"}}}}}},"post":{"tags":["Candidates"],"summary":"Register candidates on an exam (upserts them first when sent inline)","operationId":"register","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidatesBody"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/exams/search":{"post":{"tags":["Exams"],"summary":"Find exams by external_ref","operationId":"searchExams","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchExams"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/credits/quote":{"post":{"tags":["Uploads and credits"],"summary":"Quote pages, uploads (exact page counts) or typed answers","operationId":"quote","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/candidates":{"post":{"tags":["Candidates"],"summary":"Upsert institute candidates by external_id","operationId":"upsert","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidatesBody"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/candidates/search":{"post":{"tags":["Candidates"],"summary":"Find candidates by external_id","operationId":"search","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchBody"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/submissions/{submissionId}/questions/{questionId}":{"patch":{"tags":["Submissions"],"summary":"Override one question's marks and feedback (0.5 steps)","operationId":"overrideQuestion","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"questionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewQuestion"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/exams/{examId}":{"get":{"tags":["Exams"],"summary":"Get an exam; include=questions,candidates,choice_groups,stats,rubric","operationId":"getExam","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Exam"}}}}}},"delete":{"tags":["Exams"],"summary":"Delete a draft exam (or one without submissions)","operationId":"deleteExam","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"purge","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}},"patch":{"tags":["Exams"],"summary":"Edit an exam","operationId":"patchExam","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Exam"}}}}}}},"/exams/{examId}/rubrics":{"get":{"tags":["Exams"],"summary":"Rubrics and model answers of an exam","operationId":"getRubrics","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}},"patch":{"tags":["Exams"],"summary":"Set or clear rubrics / model answers of several questions in one version bump","operationId":"patchRubrics","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonNode"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/exams/{examId}/questions/{questionId}":{"delete":{"tags":["Exams"],"summary":"Remove a question from a draft exam","operationId":"deleteQuestion","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"questionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}},"patch":{"tags":["Exams"],"summary":"Edit a question (draft: anything; open: text, model_answer, rubric, tags, word_limit, expects_diagram)","operationId":"patchQuestion","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"questionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Question"}}}}}}},"/uploads/{uploadId}":{"get":{"tags":["Uploads and credits"],"summary":"An upload; checked (size, type, page count) on the first read after the PUT","operationId":"get","parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/submissions":{"get":{"tags":["Submissions"],"summary":"Feed of submissions across all exams, ordered by (updated_at, id); updated_since required","operationId":"feed","parameters":[{"name":"updated_since","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"needs_review","in":"query","required":false,"schema":{"type":"string"}},{"name":"finalized","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageMapStringObject"}}}}}}},"/submissions/{submissionId}":{"get":{"tags":["Submissions"],"summary":"A submission's status (queue position and ETA while queued)","operationId":"get_1","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}},"delete":{"tags":["Submissions"],"summary":"Delete a submission that is not finalized (e.g. a wrong upload)","operationId":"delete","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/submissions/{submissionId}/result":{"get":{"tags":["Submissions"],"summary":"Question-wise result; include=annotations,model_answer (extracted_answer on by default)","operationId":"result","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/submissions/{submissionId}/checked-copy":{"get":{"tags":["Submissions"],"summary":"The checked (annotated) copy as PDF; redirect=true gives a private-CDN link when configured","operationId":"checkedCopy","parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"redirect","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"expires_in","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/me":{"get":{"tags":["open-evaluation-me-controller"],"operationId":"me","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}}}}},"/exams/{examId}/results":{"get":{"tags":["Submissions"],"summary":"Results of an exam, one per live submission (same shape as GET /submissions/{id}/result); limit 1-50, default 20; format=csv is not available yet","operationId":"examResults","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","required":false,"schema":{"type":"string"}},{"name":"finalized","in":"query","required":false,"schema":{"type":"string"}},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"include","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageMapStringObject"}}}}}}},"/credits":{"get":{"tags":["Uploads and credits"],"summary":"Credit balance, committed credits and this institute's API rate card","operationId":"credits","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/candidates/{candidateId}":{"get":{"tags":["Candidates"],"summary":"Get a candidate by Vacademy id","operationId":"get_2","parameters":[{"name":"candidateId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/exams/{examId}/candidates/{candidateId}":{"delete":{"tags":["Candidates"],"summary":"Unregister a candidate without a submission","operationId":"unregister","parameters":[{"name":"examId","in":"path","required":true,"schema":{"type":"string"}},{"name":"candidateId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}}},"components":{"schemas":{"JsonNode":{"type":"object"},"ChoiceGroupInput":{"type":"object","properties":{"label":{"type":"string"},"question_labels":{"type":"array","items":{"type":"string"}},"attempt":{"type":"integer","format":"int32"},"policy":{"type":"string"}}},"ReplaceChoiceGroups":{"type":"object","properties":{"choice_groups":{"type":"array","items":{"$ref":"#/components/schemas/ChoiceGroupInput"}}}},"CreateUploads":{"type":"object","properties":{"files":{"type":"array","items":{"$ref":"#/components/schemas/UploadFile"}},"filename":{"type":"string"},"content_type":{"type":"string"},"size_bytes":{"type":"integer","format":"int64"},"sha256":{"type":"string"}}},"UploadFile":{"type":"object","properties":{"filename":{"type":"string"},"content_type":{"type":"string"},"size_bytes":{"type":"integer","format":"int64"},"sha256":{"type":"string"}}},"Unfinalize":{"type":"object","properties":{"reason":{"type":"string"}}},"Reevaluate":{"type":"object","properties":{"question_ids":{"type":"array","items":{"type":"string"}},"keep_reviewed":{"type":"boolean"}}},"Approve":{"type":"object","properties":{"reviewer":{"$ref":"#/components/schemas/Reviewer"}}},"Reviewer":{"type":"object","properties":{"ref":{"type":"string"},"name":{"type":"string"}}},"CandidateInput":{"type":"object","properties":{"external_id":{"type":"string"},"name":{"type":"string"},"roll_number":{"type":"string"},"section_or_class":{"type":"string"},"metadata":{"$ref":"#/components/schemas/JsonNode"}}},"CreateExam":{"type":"object","properties":{"title":{"type":"string"},"mode":{"type":"string"},"external_ref":{"type":"string"},"conducted_on":{"type":"string"},"subject":{"type":"string"},"level":{"type":"string"},"board":{"type":"string"},"answer_language":{"type":"string"},"feedback_language":{"type":"string"},"instructions":{"type":"string"},"blind":{"type":"boolean"},"open":{"type":"boolean"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/SectionInput"}},"questions":{"type":"array","items":{"$ref":"#/components/schemas/QuestionInput"}},"choice_groups":{"type":"array","items":{"$ref":"#/components/schemas/ChoiceGroupInput"}},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CandidateInput"}},"class":{"type":"string"}}},"CriterionInput":{"type":"object","properties":{"name":{"type":"string"},"marks":{"type":"number"},"keywords":{"type":"array","items":{"type":"string"}},"guidance":{"type":"string"}}},"OptionInput":{"type":"object","properties":{"label":{"type":"string"},"text":{"type":"string"}}},"QuestionInput":{"type":"object","properties":{"label":{"type":"string"},"parent_label":{"type":"string"},"section":{"type":"string"},"type":{"type":"string"},"text":{"type":"string"},"max_marks":{"type":"number"},"negative_marks":{"type":"number"},"options":{"type":"array","items":{"$ref":"#/components/schemas/OptionInput"}},"correct_options":{"type":"array","items":{"type":"string"}},"answer":{"$ref":"#/components/schemas/JsonNode"},"model_answer":{"type":"string"},"rubric":{"$ref":"#/components/schemas/RubricInput"},"word_limit":{"type":"integer","format":"int32"},"expects_diagram":{"type":"boolean"},"assess_language":{"type":"boolean"},"tags":{"type":"object","additionalProperties":{"type":"object"}},"external_id":{"type":"string"}}},"RubricInput":{"type":"object","properties":{"partial_marking":{"type":"boolean"},"instructions":{"type":"string"},"criteria":{"type":"array","items":{"$ref":"#/components/schemas/CriterionInput"}}}},"SectionInput":{"type":"object","properties":{"name":{"type":"string"},"order":{"type":"integer","format":"int32"}}},"AnswerInput":{"type":"object","properties":{"question_id":{"type":"string"},"question_label":{"type":"string"},"text":{"type":"string"},"option_labels":{"type":"array","items":{"type":"string"}},"value":{"$ref":"#/components/schemas/JsonNode"}}},"CreateSubmission":{"type":"object","properties":{"candidate":{"$ref":"#/components/schemas/CandidateInput"},"candidate_id":{"type":"string"},"upload_id":{"type":"string"},"replace":{"type":"boolean"},"metadata":{"$ref":"#/components/schemas/JsonNode"},"images":{"type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"type":"string"}},"answers":{"type":"array","items":{"$ref":"#/components/schemas/AnswerInput"}}}},"AddQuestions":{"type":"object","properties":{"questions":{"type":"array","items":{"$ref":"#/components/schemas/QuestionInput"}}}},"Finalize":{"type":"object","properties":{"submission_ids":{"type":"array","items":{"type":"string"}},"all_graded":{"type":"boolean"},"allow_partial":{"type":"boolean"}}},"CandidatesBody":{"type":"object","properties":{"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CandidateInput"}},"candidate_ids":{"type":"array","items":{"type":"string"}}}},"SearchExams":{"type":"object","properties":{"external_refs":{"type":"array","items":{"type":"string"}}}},"Quote":{"type":"object","properties":{"pages":{"type":"integer","format":"int64"},"upload_ids":{"type":"array","items":{"type":"string"}},"typed_answers":{"type":"integer","format":"int64"}}},"SearchBody":{"type":"object","properties":{"external_ids":{"type":"array","items":{"type":"string"}}}},"ReviewQuestion":{"type":"object","properties":{"awarded":{"type":"number"},"feedback":{"type":"string"},"reviewer":{"$ref":"#/components/schemas/Reviewer"},"reason":{"type":"string"}}},"ChoiceGroup":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"question_labels":{"type":"array","items":{"type":"string"}},"question_ids":{"type":"array","items":{"type":"string"}},"attempt":{"type":"integer","format":"int32"},"policy":{"type":"string"}}},"Exam":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"mode":{"type":"string"},"title":{"type":"string"},"external_ref":{"type":"string"},"conducted_on":{"type":"string"},"subject":{"type":"string"},"level":{"type":"string"},"board":{"type":"string"},"answer_language":{"type":"string"},"feedback_language":{"type":"string"},"instructions":{"type":"string"},"blind":{"type":"boolean"},"total_marks":{"type":"number","format":"double"},"paper_max":{"type":"number","format":"double"},"question_count":{"type":"integer","format":"int32"},"dashboard_url":{"type":"string"},"questions":{"type":"array","items":{"$ref":"#/components/schemas/Question"}},"choice_groups":{"type":"array","items":{"$ref":"#/components/schemas/ChoiceGroup"}},"candidates":{"type":"array","items":{"type":"object","additionalProperties":{"type":"object"}}},"rubric":{"$ref":"#/components/schemas/RubricSummary"},"quote":{"type":"object","additionalProperties":{"type":"object"}},"stats":{"type":"object","additionalProperties":{"type":"object"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/Warning"}},"opened_at":{"type":"string"},"finalized_at":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"class":{"type":"string"}}},"Option":{"type":"object","properties":{"label":{"type":"string"},"option_id":{"type":"string"},"text":{"type":"string"}}},"Question":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"parent_label":{"type":"string"},"section":{"type":"string"},"type":{"type":"string"},"text":{"type":"string"},"max_marks":{"type":"number","format":"double"},"negative_marks":{"type":"number","format":"double"},"options":{"type":"array","items":{"$ref":"#/components/schemas/Option"}},"correct_options":{"type":"array","items":{"type":"string"}},"answer":{"type":"object"},"model_answer":{"type":"string"},"rubric":{"type":"object","additionalProperties":{"type":"object"}},"word_limit":{"type":"integer","format":"int32"},"expects_diagram":{"type":"boolean"},"assess_language":{"type":"boolean"},"tags":{"type":"object","additionalProperties":{"type":"object"}},"external_id":{"type":"string"},"rubric_version":{"type":"integer","format":"int32"},"rubric_sync":{"type":"string"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/Warning"}}}},"RubricSummary":{"type":"object","properties":{"version":{"type":"integer","format":"int32"},"locked":{"type":"boolean"},"questions_with_rubric":{"type":"integer","format":"int32"},"questions_without_rubric":{"type":"integer","format":"int32"},"sync":{"type":"string"},"sync_error":{"type":"object","additionalProperties":{"type":"object"}}}},"Warning":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}}},"PageMapStringObject":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{"type":"object"}}},"next_cursor":{"type":"string"},"has_more":{"type":"boolean"}}},"MeResponse":{"type":"object","properties":{"key_id":{"type":"string"},"name":{"type":"string"},"institute_id":{"type":"string"},"institute_name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"rate_tier":{"type":"string"},"daily_copy_quota":{"type":"integer","format":"int32"},"daily_copy_cap":{"type":"integer","format":"int32"},"quota_used_today":{"type":"integer","format":"int32"},"quota_resets_at":{"type":"string"}}},"PageExam":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Exam"}},"next_cursor":{"type":"string"},"has_more":{"type":"boolean"}}}},"securitySchemes":{"ApiKey":{"type":"apiKey","name":"X-API-Key","in":"header"}}}}