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

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" }'

Endpoints

5 pages