Skip to main content
POST
Start a room

Authorizations

Authorization
string
header
required

An API key from Settings › API, sent as Authorization: Bearer ptr_…. Shown once when made; only a hash is stored.

Body

application/json
deckId
string
required

The deck's id

Minimum string length: 1

Response

OK

code
string
required

The six-digit join code

hostToken
string
required

The host's key for this room; whoever holds it drives the session

joinUrl
string
required

Where the audience joins

presentUrl
string
required

The presenter's view, with the host key in the fragment so a person can take over