api changelog

https://www.quiz.video/llms.txt

− - Quizzes created through the API are published (public) immediately. To make one private, send `PATCH /api/v1/quizzes/{id}` with `{ "isPublished": false }`.+ - Get a link where people take a quiz in their browser with no sign-in, and see how they did: `POST /api/v1/quizzes/{id}/share` (MCP: `quiz_video_share_quiz`) and `GET /api/v1/quizzes/{id}/results` (MCP: `quiz_video_get_quiz_results`).+ - Put the user's own images, clips, backgrounds, intro, outro and sounds in a quiz: `POST /api/v1/media/uploads`, PUT the file to the returned URL, `POST /api/v1/media/uploads/{id}/complete`, then `PATCH /api/v1/quizzes/{id}/media` (MCP: `quiz_video_create_media_upload`, `quiz_video_complete_media_upload`, `quiz_video_update_quiz_media`).+ - Style a quiz with `quiz_video_update_quiz` or `PATCH /api/v1/quizzes/{id}`: `themeCustomization.fontFamilyOverride`, `textColorOverride`, `answerTextColorOverride`, `accentColorOverride`, `backgroundColorOverride`, plus `questionFontSize` (default 120) and `answerFontSize` (default 96). These apply to built-in and custom templates. Text never clips, so it stops growing once it fills its space.+ - Quizzes created through the API are published (public) immediately. To change that, send `POST /api/v1/quizzes/{id}/share` with `{ "visibility": "private" | "unlisted" | "public" }`; unlisted quizzes open for anyone with the link and are never listed or indexed.+ - POST /api/v1/quizzes/:id/share - Set visibility and get a play link (body: { visibility: private | unlisted | public }, default unlisted). Returns visibility, playUrl, quizUrl, embedHtml+ - GET /api/v1/quizzes/:id/results - Get plays, completions, average score and hardest questions+ - GET /api/v1/quizzes/:id/media - Read a quiz's images, clips, backgrounds, intro, outro and sound effects+ - PATCH /api/v1/quizzes/:id/media - Set them, using asset ids from your library (body: quiz, questions[], answers[])+ - POST /api/v1/media/uploads - Start an upload (body: filename, contentType, size, kind, purpose). Returns a presigned uploadUrl+ - POST /api/v1/media/uploads/:id/complete - Validate the uploaded file and make it usable+ - GET /api/v1/media - List your media library (query: kind, limit)+ - DELETE /api/v1/media/:id - Delete a file (409 while a quiz uses it)

• + quiz_video_share_quiz
• + quiz_video_get_quiz_results
• + quiz_video_create_media_upload
• + quiz_video_complete_media_upload
• + quiz_video_list_media
• + quiz_video_delete_media
• + quiz_video_get_quiz_media
• + quiz_video_update_quiz_media

• + get_api_index

https://www.quiz.video/llms.txt

− # Quiz.Video API− > Quiz.Video is an AI-powered quiz and flashcard creation platform. The API allows programmatic access to create, manage, and generate quizzes and flashcards.− ## Base URL− https://www.quiz.video/api/v1− ## Authentication− All API requests require an API key passed via the x-api-key header.− Get your API key at https://www.quiz.video/app/settings (API Keys tab).− ## Endpoints− ### Quizzes− ### Renders− ### Flashcards− - POST /api/v1/flashcards - Create a deck (body: title, description)− ### Account− ## Rate Limiting− Default: 1000 requests per day per API key.− Rate limit headers are included in responses.− ## Response Format− Success: { "data": ... }− Error: { "error": "message", "code": "ERROR_CODE" }− ## Documentation− Full API documentation: https://www.quiz.video/docs/api/+ # Quiz.Video+ > Quiz.Video turns a topic, notes, a document, or a YouTube video into a multiple-choice quiz or flashcard deck and renders it as a short vertical video for TikTok, YouTube Shorts, and Instagram Reels. Agents can drive it through a REST API (https://www.quiz.video/api/v1) or a remote MCP server (https://www.quiz.video/mcp/).+ **When to use Quiz.Video.** Reach for it when the user wants one of these jobs done:+ - Generate a quiz on a topic at a chosen difficulty and question count: `POST /api/v1/quizzes/generate` (MCP: `quiz_video_generate_quiz`).+ - Turn questions you or the user already wrote into a styled quiz: `POST /api/v1/quizzes` with `questions[]` (MCP: `quiz_video_create_quiz`).+ - Build a flashcard deck for studying: `POST /api/v1/flashcards` (MCP: `quiz_video_create_flashcard_deck`).+ - Produce a shareable quiz video and a download link: `POST /api/v1/renders`, poll `GET /api/v1/renders/{sessionId}` until `completed`, then `POST /api/v1/renders/{sessionId}/download` (paid plans).+ - List, edit, re-theme, or delete quizzes and decks the user already has on Quiz.Video.+ Quiz.Video is not a general-purpose video editor: it makes quiz and flashcard content.+ **How to call it.** Agents with MCP support should connect to https://www.quiz.video/mcp/ (OAuth 2.1 with dynamic client registration, handled by the client). Other agents call the REST API with an API key in `x-api-key` or an OAuth access token in `Authorization: Bearer`; request the token with `resource=https://www.quiz.video/api/v1` so a JWT is issued.+ **Quiz creation defaults.**+ - Quiz generation and creation accept `themeDescription` (natural language, e.g. "golden luxury game show") or `themeCustomization` (explicit hex colors and font). Send one so the saved quiz has a coherent visual theme; without either, the server derives a theme from the topic or title.+ - Omit `backgroundMusicId` to use the default YouTube-safe background music. Set it to `null` only when the user wants a silent quiz. List tracks with `GET /api/v1/music` (MCP: `quiz_video_list_music`).+ - Quizzes created through the API are published (public) immediately. To make one private, send `PATCH /api/v1/quizzes/{id}` with `{ "isPublished": false }`.+ **API endpoints.** Base URL https://www.quiz.video/api/v1 (`GET /api/v1/` lists every resource without authentication):+ - POST /api/v1/flashcards - Create a deck (body: title, description, tags, cards[{ front, back, hint }]; at least one card)+ **Limits, errors, and versioning.**+ - Rate limit: each API key has a budget of 1,000 requests, which refills once the key has made no requests for 24 hours. API-key responses include `RateLimit-Policy`, `RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset`. A 429 `RATE_LIMITED` response includes `Retry-After` (seconds).+ - Errors are JSON: `{ "error": "message", "code": "ERROR_CODE", "hint": "how to fix", "docs": "https://www.quiz.video/docs/api/#error-codes" }`. Branch on `code`.+ - Success: `{ "data": ... }`; lists add `pagination: { page, limit, total, totalPages }`.+ - Versioning: the major version is in the path (/api/v1). Breaking changes only ship under a new path; deprecated operations send `Deprecation` and `Sunset` headers at least 90 days before removal.+ - Plans: API keys work on every plan. The free plan creates 1 quiz per month and renders carry a watermark; `403 FREE_PLAN_LIMIT_REACHED` means the user must upgrade.+ ## Docs+ - [Developer portal](https://www.quiz.video/developers/): API keys, quickstart, MCP, testing on the free plan, rate limits, versioning policy+ - [API reference](https://www.quiz.video/docs/api/): every endpoint with request and response examples+ - [OpenAPI 3.1 specification](https://www.quiz.video/.well-known/openapi.json): machine-readable contract for all /api/v1 operations+ - [MCP server guide](https://www.quiz.video/docs/mcp/): connecting Claude, ChatGPT, and other MCP clients+ - [Agent skill](https://www.quiz.video/.well-known/agent-skills/quiz-video-api/SKILL.md): step-by-step integration skill for agents+ - [Versioning and deprecation policy](https://www.quiz.video/developers/#versioning): what can change within v1 and how removals are announced+ - [Pricing](https://www.quiz.video/pricing/): free plan and paid plans+ ## Authentication+ - [auth.md](https://www.quiz.video/auth.md): how an agent obtains credentials, step by step+ - [OAuth protected resource metadata](https://www.quiz.video/.well-known/oauth-protected-resource/api/v1): resource, authorization server, and scopes (`api:read`, `api:write`)+ - [OAuth authorization server metadata](https://www.quiz.video/.well-known/oauth-authorization-server): dynamic client registration, authorization code + PKCE, refresh tokens+ - [API keys](https://www.quiz.video/app/settings/): create one in the API Keys tab and send it as `x-api-key: qv_...`+ ## Optional+ - [API index](https://www.quiz.video/api/v1/): public JSON entry point listing every resource+ - [API catalog (RFC 9727)](https://www.quiz.video/.well-known/api-catalog)+ - [Agentic resource discovery manifest](https://www.quiz.video/.well-known/ard.json)+ - [MCP server card](https://www.quiz.video/.well-known/mcp/server-card.json)