Mark

The Mark API marks student work with AI. There are two paths. Requires the mark app.

Assessment marking — mark a student’s completed PDF against a published assessment (an exam, SAC, etc.). This is the recommended path and is how generated exams are marked.
Essay marking — mark a free-form essay against criteria, with no pre-defined assessment.

Both are asynchronous: submit, then receive the result via a marking.completed webhook or by polling. The pipeline is: extraction → answer matching → marking → summary.

Marking a generated exam

Generate a paper with the Exams API, then submit the student’s work here using the paper’s assessment_id:

Endpoints

List assessments · Retrieve an assessment
Mark a submission · Retrieve a submission · Remark a submission
Mark an essay · Retrieve an essay marking

cURL

curl -X POST "https://ai.intu.com.au/api/v1/mark/submissions" \
  -H "Authorization: Token token=sk_intu_api_<your_api_key>" \
  -F "user_id=student-001" \
  -F "assessment_id=<assessment_id from the exam>" \
  -F "file=@completed_paper.pdf"