Quizzes

Generate a multiple-choice quiz for a subject and topics. Generation is asynchronous: create a quiz, then receive it via a webhook or by polling. Requires the quiz app.

The quiz object

Attribute	Type	Description
`id`	uuid	Quiz identifier
`title`	string	Generated title
`status`	string	`pending`, `processing`, `completed`, or `failed`
`subject`	object	The subject
`topics`	array	The topics covered
`difficulty`	string	`easy`, `medium`, or `hard`
`questions`	array	Populated once `completed`; each has `text`, `options`, `correct_answer`, `explanation`
`usage`	object	`total_tokens` for billing

Endpoints

Create a quiz — POST /api/v1/quizzes
Retrieve a quiz — GET /api/v1/quizzes/:id

Response

{
  "id": "d77e1ea3-...",
  "title": "Heredity — Mixed Quiz",
  "status": "completed",
  "difficulty": "medium",
  "questions": [
    {
      "text": "Which process increases genetic variation?",
      "options": { "A": "Mitosis", "B": "Crossing over", "C": "Diffusion", "D": "Translation" },
      "correct_answer": "B",
      "explanation": "Crossing over recombines alleles between homologous chromosomes."
    }
  ],
  "usage": { "total_tokens": 3350 }
}