POST /api/v1/quizzes/update

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.