POST
/api/v1/mark/adhoc
Mark ad-hoc work (no assessment)
Marks a student’s uploaded work when you have no pre-defined assessment / answer key. The marking criteria, expected answer, and — where justified — the mark value are inferred from syllabus outcomes and real exam marking guidance. Works for all subjects and all work types (MCQ, short answer, worked/calculation, diagram). An essay/extended-response is auto-detected and routed to essay marking.
Returns 202 Accepted with a submission_id; poll Retrieve ad-hoc marking or await the marking.completed webhook.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
user_id |
string | required | Your identifier for the student (billing) |
file |
file/url | required | The student’s work (PDF or image) |
subject_id |
uuid | optional | Subject to ground marking in. If omitted, the subject is inferred. |
question |
string | optional | The question the student was answering, if you know it |
marks_total |
integer | optional | Total marks for the task. When supplied, results are returned as X/N. |
marks_per_question |
object | optional | Per-question marks, e.g. {"1":2,"2":3}. Overrides marks_total. |
When no marks hint is supplied and the question carries no explicit allocation, marking is qualitative (correct / partial / incorrect + an overall percentage and band) — no invented denominators.