Skip to main content
POST
/
api
/
v1
/
quizzes
/
generate
Generate a quiz with AI
curl --request POST \
  --url https://quizquail.com/api/v1/quizzes/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "topic": "Ancient Roman history",
  "options": {
    "rounds": 5,
    "questionsPerRound": 10,
    "difficulty": 3,
    "questionTypes": [
      "<string>"
    ],
    "questionDurationSeconds": 16.5,
    "answerDurationSeconds": 8.5,
    "factDurationSeconds": 8.5,
    "hintTimingPercent": 50
  }
}
'
"<string>"

Documentation Index

Fetch the complete documentation index at: https://docs.quiz-quail.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key authentication. Prefix your key with Bearer in the Authorization header.

Keys follow the format qq_... and can be scoped to specific permissions.

Body

application/json
​
topic
string
required

Topic for AI quiz generation

Required string length: 1 - 500
Example:

"Ancient Roman history"

​
options
object

Response

SSE stream of generation progress

Server-Sent Events stream