Skip to navigation
API ReferenceDory

Ask Question

Ask a question. On a moderated event it arrives PENDING and waits for a host, which is the whole point of that setting.

Unlike asking in the room, this works whatever the event’s phase or question window: it is how questions collected elsewhere are imported, before or after the event, and how an integration asks on a participant’s behalf. The event’s profanity filter still applies.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

eventIdstringRequired

Request

This endpoint expects an object.
bodystringRequired
1 to 2,000 characters.
isAnonymousbooleanOptional
participantIdstringOptional
Whose question it is. Left out, it is the key's own. A participant named here must belong to this event.

Response

This endpoint returns an object.
idstring
eventIdstring
bodystring
statusenum
Allowed values:
isAnonymousboolean
highlightedboolean
On the presenter screen. Only one question in an event is highlighted at a time, and never a dismissed one.
upvoteCountinteger
createdAtdatetime
updatedAtdatetime
answerTextstringOptional
answeredAtdatetimeOptional

When it moved into ANSWERED. Kept while it stays answered, so a second answer does not move it; cleared when it moves out.

editedAtdatetimeOptional
Set when the asker rewrote it after the room had voted.
askerobjectOptional

Who asked. Absent on an anonymous question: the participant row exists so that one person cannot vote twice, and handing it back through a key would undo the promise made to whoever asked.

Errors

403
Forbidden Error
404
Not Found Error
422
Validation Error
429
Too Many Requests Error