POST /api/v1/mark/submissions

Mark a submission

Submits a student’s completed PDF to be marked against a published assessment. Returns 202 Accepted with a submission_id; results arrive via the marking.completed webhook or by polling. Upload as multipart form-data (a file part or a URL).

Parameters

Name	Type	Required	Description
`user_id`	string	required	Your identifier for the student (billing)
`assessment_id`	uuid	required	The published assessment to mark against
`file`	file/url	required	The student’s completed paper (PDF)
`external_reference`	string	optional	Your own reference echoed back on the result
`exams_attempt_id`	uuid	optional	Link the submission to an exam attempt

Returns

A submission_id, status, and a view_url.

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=9c8b7a6d-..." \
  -F "file=@completed_paper.pdf"

Response

{
  "submission_id": "a3f1b2c4-...",
  "status": "pending",
  "view_url": "https://ai.intu.com.au/mark/mark_submissions/a3f1b2c4-..."
}