POST /
Create a Quiz
Create a new quiz with the public v1 request contract. This page covers the request fields, the supported steering values, and the exact response you can parse in production.
POST
https://vidbyte-backend.onrender.com/ api/ v1/ quizzes/ create
Example request
bash
curl https://vidbyte-backend.onrender.com/api/v1/quizzes/create \
-H "x-api-key: vb_live_your_api_key" \
-H "Idempotency-Key: quiz-create-001" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Assess whether junior engineers understand HTTP caching",
"content": "Cache-Control, ETag, revalidation, and freshness lifetime",
"quiz_type": "multiple_choice",
"reasoning_lens": "first_principles_thinking"
}'Example response
JSON
{
"success": true,
"encrypted_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"message": "Quiz created successfully.",
"data": {
"encrypted_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"title": "HTTP caching mastery check",
"description": "Assess whether junior engineers understand freshness, validators, and revalidation.",
"quiz_type": "multiple_choice",
"quiz_data": {
"title": "HTTP caching mastery check",
"total_questions": 5,
"questions": [{ "question": "What does Cache-Control do?" }]
},
"status": "active",
"tags": [],
"version": 1,
"actions_applied": [],
"created_at": "2026-03-12T10:00:00",
"updated_at": "2026-03-12T10:05:00"
},
"token_stats": { "input_tokens": 782, "output_tokens": 663, "total_tokens": 1445 },
"pricing": { "total_cost": 0.0217 },
"object": "quiz"
}Parameter information
These are the public parameters for /api/v1/quizzes/create. Path, query, and request-body parameters are shown together so the page stays focused on the live request contract you actually send.
titlestringOptional
Currently rejected: the input validator returns 400 Invalid Field for this field. Intended as an optional saved title for the quiz resource.