POST /
Update a Quiz
Progressively update an existing quiz by semantic action groups instead of rebuilding it from scratch. This route is useful when your product supports iterative quiz refinement.
POST
https://api.vidbyte.pro/ api/ v1/ quizzes/ update
Example request
bash
curl https://api.vidbyte.pro/api/v1/quizzes/update \
-H "x-api-key: vb_live_your_api_key" \
-H "Idempotency-Key: quiz-update-001" \
-H "Content-Type: application/json" \
-d '{
"quiz_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"actions": {
"difficulty": "harder",
"reasoning": "first principles",
"next_quiz": "next sequential topic"
},
"prompt": "Make the quiz more diagnostic for backend interviews"
}'Example response
JSON
{
"success": true,
"encrypted_id": "6ec0bd7f-11c0-43da-975e-2a8ad9ebae0b",
"message": "Quiz updated successfully.",
"data": {
"encrypted_id": "6ec0bd7f-11c0-43da-975e-2a8ad9ebae0b",
"title": "HTTP caching mastery check",
"description": "A harder follow-up quiz for backend interview prep.",
"quiz_type": "multiple_choice",
"quiz_data": { "title": "HTTP caching mastery check", "questions": [{ "question": "Why does ETag support safe revalidation?" }] },
"status": "active",
"tags": [],
"version": 2,
"actions_applied": ["make_harder", "first_principles", "generate_sequential"],
"created_at": "2026-03-12T11:00:00",
"updated_at": "2026-03-12T11:00:00",
"parent_quiz_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
},
"token_stats": { "input_tokens": 411, "output_tokens": 287, "total_tokens": 698 },
"pricing": { "total_cost": 0.0101 },
"object": "quiz"
}Parameter information
These are the public parameters for /api/v1/quizzes/update. Path, query, and request-body parameters are shown together so the page stays focused on the live request contract you actually send.
quiz_idstringRequired
The encrypted_id of the existing quiz you want to modify, a UUIDv4 share token exactly as create, list, or get returned it. Any other format gets 400.