POST /api/v1/quizzes

Create a quiz

Creates a quiz for a subject and topics. Returns 202 Accepted immediately with a quiz_id and status: pending. Await the quiz.completed webhook or poll Retrieve a quiz.

Parameters

Name	Type	Required	Description
`user_id`	string	required	Your identifier for the student (billing)
`quiz.subject_id`	uuid	required	Subject (must be on your subscription)
`quiz.topic_ids`	array	required	One or more topic UUIDs to draw from
`quiz.difficulty`	string	required	`easy`, `medium`, or `hard`
`quiz.duration`	integer	required	Target length in minutes, from 1 to 60

Returns

A pending quiz object echoing your inputs, plus a poll_url.

cURL

curl -X POST "https://ai.intu.com.au/api/v1/quizzes" \
  -H "Authorization: Token token=sk_intu_api_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "student-001",
    "quiz": {
      "subject_id": "b1d9b7d4-06bc-45d1-95af-a441eb9b928b",
      "topic_ids": ["d85701b5-f957-4219-8bbf-eb3400f73990"],
      "difficulty": "medium",
      "duration": 10
    }
  }'

Response

{
  "quiz_id": "d77e1ea3-c81a-4fc8-8929-7ba959a8431f",
  "status": "pending",
  "subject": { "id": "b1d9b7d4-...", "name": "HSC Biology" },
  "difficulty": "medium",
  "duration": 10,
  "poll_url": "https://ai.intu.com.au/api/v1/quizzes/d77e1ea3-..."
}