Skip to main content
POST
Create a session

Authorizations

Authorization
string
header
required

Same HMAC as cookie ws_host. Mint via POST /api/me/token.

Body

application/json
title
string
required
prompt
string

If set, creates a draft poll.

options
string[]

2–8 labels when the kind needs options.

kind
enum<string>
Available options:
multiple_choice,
word_cloud,
quiz,
rating,
open_text,
ranking
correctIndex
integer

Quiz key index into options.

tz
string

IANA TZ. Default UTC. Session auto-ends at that EOD.

k
string

Response

Created session plus host key.

id
string<uuid>
required
k
string
required

Host key. Treat as a secret.

code
string
required

5-char join code.