Assessment generation plus progressive updates
Quizzes API
The Quizzes API covers the full quiz lifecycle: create a quiz, batch-generate multiple quizzes, list and fetch saved quizzes, and progressively update an existing quiz by semantic action groups.
1. Think about quiz generation in two layers
For most callers, the public v1 mental model should stay flat: prompt, content, quiz_type, reasoning_lens, and context are the fields create accepts today. The other documented steering fields, such as difficulty and length, are currently rejected with 400 Invalid Field.
For power users, Vidbyte's quiz engine also has a richer internal attribute system covering question design, content relationship, answer-choice architecture, and quiz info. The public route normalizes into those structures behind the scenes.
2. The family supports generation, retrieval, and progressive refinement
Use /create for a single quiz.
Use /batch_create when you need multiple variants in one request envelope.
Use /list and /get for saved quiz retrieval.
Use /update when the product needs to make an existing quiz harder, longer, or more focused without starting over.
3. Keep the first integration focused on a few clear steering knobs
Quiz type
Pick the question form you actually need first, such as multiple choice, true/false, or open ended.
Difficulty and length
Not settable on create yet: difficulty and length are currently rejected with 400 Invalid Field. Change an existing quiz with /update actions such as harder or longer.
Reasoning and focus
Add reasoning_lens when the product needs sharper control over what the quiz is testing. content_focus is currently rejected with 400 Invalid Field.
curl request
Quiz create example
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"
}'Endpoints
/create
/
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.
/batch-create
/
Generate multiple quizzes in one request envelope. This route is designed for scenarios where you need several quiz variants or per-learner quiz generation in one call.
/get
/
Fetch one previously generated quiz by encrypted public id. Use this after your application has persisted the id returned from create, batch create, or list.
/list
/
List the quizzes owned by the authenticated principal. This route is useful for history views, audit trails, and state reconciliation in client applications.
/update
/
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.