Skip to navigation
API ReferenceDory

Update Question

Approve it, answer it, put it on the screen, or dismiss it, under the app’s own rules. Only one question is highlighted: highlighting this one takes any other off the presenter screen, and dismissing it (status: DISMISSED) takes it off, leaving the screen empty. answeredAt is stamped as it becomes ANSWERED and kept while it stays so.

Authentication

AuthorizationBearer

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

Path parameters

questionIdstringRequired

Request

This endpoint expects an object.
bodystringOptional
1 to 2,000 characters. Marks the question edited.
statusenumOptional

DISMISSED also takes it off the presenter screen, as DELETE does: a dismissed question is never highlighted.

Allowed values:
highlightedbooleanOptional

true puts it on the presenter screen and takes off whichever question was there: only one question is highlighted per event. false takes it off. Ignored alongside status: DISMISSED, which takes it off.

answerTextstringOptional
Up to 5,000 characters.

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