Exams

Generate full HSC-style practice exam papers. Generation is asynchronous and the flow mirrors Quizzes. Requires the exams_api app.

1. Create a paper with a subject, topics, duration and difficulty → 202 Accepted.
2. We generate the questions and render all three documents.
3. You receive an exam.completed webhook once everything is ready (or poll the paper).
4. Retrieve the paper and fetch all three documents in your chosen format (?delivery=html or ?delivery=pdf).
5. To mark a sat paper, submit the student’s work to the Mark API with the paper’s assessment_id.

The three documents

Document	Description
student_paper	The questions the student sits
writing_booklet	A blank answer booklet
solutions	Worked solutions / marking guidelines

Choose the format at fetch time: ?delivery=html returns inline HTML, ?delivery=pdf returns signed, expiring download URLs. You render them yourself.

Endpoints

• Create a paper — POST /api/v1/exams/papers
• Retrieve a paper — GET /api/v1/exams/papers/:id