Change settings, or end / reopen voting

patch/api/admin/{slug}

Request

  • Base URL: https://qrvote.org
  • URL: https://qrvote.org/api/admin/{slug}
  • 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

titlestring
descriptionstring
results'live' | 'after' | 'private'
allowChangeboolean
requireBallotboolean
ipLimitinteger
opensAtinteger nullable
closesAtinteger nullable
criteriastring[]

Contests: what judges score, 1–10 each. Empty turns judging off.

themestring

classic, halloween, harvest, winter, garden, carnival, beach, sports, hearts, stars, lunar, diwali, muertos, hanami, cats, dogs, campfire, art, trivia, classroom, cookoff, science, wedding, carshow, workplace, or custom:<accent hex>-<second hex> (e.g. custom:1a73e8-ff8a5b)

lang'en' | 'es' | 'de' | 'zh' | 'fr' | 'pt' | 'ja' | 'ko' | 'it' | 'hi' | 'id' | 'tr' | 'ar'

The voters' language: the contest's QR codes and links open in it (anyone can switch). Defaults to en.

closedboolean

true ends voting now; false reopens it

Response

Updated dashboard data

Changes

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