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

/api/v1/quizzes/update

Example request

curl https://api.vidbyte.ai/api/v1/quizzes/update \
  -H "Authorization: Bearer vb_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "quiz_id": "quiz_9Yv7k12Lm",
    "actions": {
      "difficulty": "harder",
      "reasoning": "first principles",
      "next_quiz": "next sequential topic"
    },
    "prompt": "Make the quiz more diagnostic for backend interviews"
  }'

Example response

{
  "success": true,
  "id": "quiz_2hL9md4Xp",
  "data": {
    "id": "quiz_2hL9md4Xp",
    "item_type": "quiz",
    "title": "HTTP caching mastery check",
    "description": "A harder follow-up quiz for backend interview prep.",
    "actions_applied": ["make_harder", "first_principles", "next_topic"],
    "parent_quiz_id": "quiz_9Yv7k12Lm",
    "quiz_data": { "title": "HTTP caching mastery check", "questions": [{ "question": "Why does ETag support safe revalidation?" }] }
  },
  "token_stats": { "input_tokens": 411, "output_tokens": 287, "total_tokens": 698 },
  "pricing": { "total_cost": 0.0101 }
}

Parameter information

These are the public parameters for /api/v1/quizzes/update. Path parameters and request-body fields are shown together so the page stays focused on the live request contract you actually send.

quiz_idstringRequired

The encrypted public quiz id of the existing quiz you want to modify.