Run a live quiz: start, reveal, next question, finish, or pause/resume its clock

For quizzes with host = true. Body: { action: 'start' | 'reveal' | 'next' | 'finish' | 'pause' | 'resume' }. Steps must follow lobby → question → reveal → question … → done; anything else is 409. With hostSecs > 0 the quiz also moves on by itself (each question hostSecs seconds, each answer shown 8 s); pause/resume stop and restart that clock, and a step by hand restarts it.

post/api/admin/{slug}/host

Request

  • Base URL: https://qrvote.org
  • URL: https://qrvote.org/api/admin/{slug}/host
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://qrvote.org/authorize, token URL https://qrvote.org/oauth/token, scopes: read, manage)

Path parameters

slugstring required

The id in the public link, e.g. scarecrow-contest-2026-ab12 from https://qrvote.org/c/scarecrow-contest-2026-ab12

Request body

action'start' | 'reveal' | 'next' | 'finish' | 'pause' | 'resume' required

Response

OK

object required

Changes

No recorded changes to this operation across all 1 revision of this API.