POST /api/v1/quizzes/batch_create

Batch Create Quizzes

This page offers a clear overview of Batch Create Quizzes. It helps you explore this topic and find a useful next step.

POST

https://vidbyte-backend.onrender.com/api/v1/quizzes/batch_create

Example request

bash

curl https://vidbyte-backend.onrender.com/api/v1/quizzes/batch_create \
  -H "x-api-key: vb_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "prompt": "HTTP caching", "quiz_type": "multiple_choice" },
      { "prompt": "HTTP caching", "quiz_type": "open_ended" }
    ]
  }'

Example response

JSON

{
  "success": true,
  "data": [
    {
      "index": 0,
      "success": true,
      "id": "quiz_9Yv7k12Lm",
      "quiz_type": "multiple_choice",
      "data": { "id": "quiz_9Yv7k12Lm", "item_type": "quiz", "title": "HTTP caching mastery check" }
    },
    {
      "index": 1,
      "success": true,
      "id": "quiz_f1Pq23ZaR",
      "quiz_type": "open_ended",
      "data": { "id": "quiz_f1Pq23ZaR", "item_type": "quiz", "title": "HTTP caching reflection prompts" }
    }
  ],
  "token_stats": { "input_tokens": 1311, "output_tokens": 1124, "total_tokens": 2435 },
  "pricing": { "total_cost": 0.0389 }
}

Parameter information

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

itemsobject[]Required

Array of quiz-create payloads. Each item should look like a normal quiz create request, and the current backend supports between 1 and 15 items per batch.