---
title: "Draft quiz video"
method: POST
path: "/videos/drafts/quiz"
---

# Draft quiz video

`POST /videos/drafts/quiz`

## Request

- Base URL: `https://api.shortgenius.com/v1`
- URL: `https://api.shortgenius.com/v1/videos/drafts/quiz`
- Auth: HTTP bearer

Make a quiz on the provided topic. After calling this endpoint, call [Create Video](#tag/videos/POST/videos) with the results to create the video.

## Request body

- object
  - `topic` string, required: The topic you would like to make a quiz about.
  - `locale` 'af-ZA' | 'id-ID' | 'ms-MY' | 'ca-ES' | 'cs-CZ' | 'da-DK' | 'de-DE' | 'en-US' | 'es-ES' | 'es-419' | 'fr-CA' | 'fr-FR' | 'hr-HR' | 'it-IT' | 'hu-HU' | 'nl-NL' | 'no-NO' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'sk-SK' | 'fi-FI' | 'sv-SE' | 'vi-VN' | 'tr-TR' | 'el-GR' | 'ru-RU' | 'sr-SP' | 'uk-UA' | 'hy-AM' | 'he-IL' | 'ur-PK' | 'ar-SA' | 'hi-IN' | 'th-TH' | 'ko-KR' | 'ja-JP' | 'zh-CN' | 'zh-TW' | 'auto': The locale of the video.

## Response `200`

Successful response

- DraftQuizVideo: Scenes suitable for a quiz-style video.
  - `title` string, required: The title of the video.
  - `caption` string, required: The description shown beside the video when posted to social media.
  - `quiz` object, required
    - `questions` object[], required
      - `question` string, required: A quiz question.
      - `options` object[], required
        - `text` string, required
        - `correct` boolean, required
    - `results` object, required
      - `header` string, required: The header shown at the top of the quiz results.
      - `explanation` string, required: The text the AI narrates when showing the quiz results.
      - `categories` object[], required
        - `score_range` string, required: The number of questions viewers in this category got right (e.g., "1-2").
        - `title` string, required: The title of the category.

## Other responses

- `400`: Invalid request
- `401`: Unauthorized request

---

[API](https://skmtc.dev/shortgenius/apis/shortgenius-api.md) · [All operations](https://skmtc.dev/shortgenius/apis/shortgenius-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shortgenius/apis/shortgenius-api/revisions/532abda8ff32?raw)