Vidbyte

API documentation

POSTLivePOSTFocused route reference

POST /api/v1/quizzes/batch_create

Batch Create Quizzes

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.

Manage keys
Stable public contract

Public endpoint

/api/v1/quizzes/batch_create

Maps to

/api/sandbox/create_quiz

What to know first

Best for cohort-style workloads or when you want several quiz variants returned together.

Method

POST

Send this operation to /api/v1/quizzes/batch_create on the versioned public host.

Authentication

API key

API key via Authorization: Bearer or x-api-key

Resource model

Direct

Best for cohort-style workloads or when you want several quiz variants returned together.

Highlights

What this operation does

Generate multiple quizzes sequentially in one request envelope.
Best for cohort-style workloads or when you want several quiz variants returned together.
Store the encrypted `id` returned by create and list routes exactly as returned if you need to fetch the resource again later.

Request details

Request parameters

Request parameters

These are the parameters that shape /api/v1/quizzes/batch_create. Path parameters and request-body fields are shown together because the docs stay focused on the public route contract.

itemsobject[]Required

Array of quiz create payloads. The current backend supports 1 to 20 items per batch.

Response shape

What the response contract guarantees

Public responses use the shared envelope: `success`, `id`, `message`, `data`, `token_stats`, `pricing`, and `error`.
The `id` field is always a public/encrypted identifier boundary, never a raw MongoDB `_id`.
Batch create returns one result object per requested quiz plus aggregated `token_stats` and `pricing`.