This method allows users to update currently existing polls. The only facet of the poll that can be updated is its visibility (whether it is showing or hidden). The text of the poll (question and answers) cannot be updated, to avoid discrepancies in poll results if users vote prior to the poll being updated.
In addition to the parameters listed in the Request Parameters section, the poll/update method also includes the following parameters:
Parameter
Description
Required
event_code
The event code for the event in which the poll is being updated. Each CiL event that is created is assigned a unique event code that identifies it in the database - The event owner can find this value after creating a new event, by selecting the "altcast_code" which is found in their Viewer Window embed code (e.g. the event code is "46e6cd22b5" in "altcast_code=46e6cd22b5"). This value is also returned by the event/list API method.
yes
poll_id
The id of the poll to be updated. Returned by the poll/list and poll/create API methods.
yes
status
The visibility of the poll, which is being updated. Possible values include:
publish - show the poll. Is only valid if the poll being updated is in a hidden state.
hide - hide the poll. Is only valid if the poll being updated is in a published state.
yes
The Response
There is no extra data returned from a poll/update request, so the response has the same fields as a general response.
Example response to a successful poll/update request: