POST /api/v1/quizzes/create

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://api.vidbyte.pro/api/v1/quizzes/create

Example request

bash
curl https://api.vidbyte.pro/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.