Vote Kit icon

Vote Kit

Consume Vote Kit API

Actions8

Update Vote

AI-generated

Overview

This node operation updates an existing vote (poll) in the Vote Kit system. It allows modifying various attributes of the vote such as title, description, maximum votes per user, winner count, start and end times, visibility settings, bonus configurations, option limits, and the list of vote options. This operation is useful for administrators or users managing polls who need to change poll details after creation, for example, extending the deadline, changing the number of winners, or updating the options available for voting.

Use Case Examples

  1. An event organizer updates a poll to extend the voting deadline and add more options for attendees to choose from.
  2. A community manager modifies the description and voting rules of an ongoing poll to clarify participation guidelines.

Properties

Name Meaning
Title Title of the vote to be updated.
Description Description of the vote to provide additional context or information.
Max Vote Per User Maximum number of votes allowed per user in the poll.
Winner Count Number of winners to be selected in the poll.
Start Time Start time of the voting period.
End Time End time (deadline) of the voting period.
Public Voter Info Whether voter information is publicly visible.
Public Option Create Whether the public can create options in the poll.
Public Comment Whether comments are allowed on the poll.
Allow Update Vote Whether voters are allowed to update their votes.
Hide Result Before End Whether to hide poll results before the poll ends.
Has Bonus Whether the poll includes a bonus feature.
Share Bonus to Voters Whether to share the bonus with voters.
Bonus Percentage for Voters Percentage of the bonus shared with voters if enabled.
Limit Options Per User Whether to limit the number of options a user can select.
Max Options Per User Maximum number of options a user can select if option limit is enabled.
Vote Options List of options available for voting in the poll.
Vote ID Identifier of the vote (poll) to update.

Output

JSON

  • _id - Unique identifier of the updated vote.
  • title - Title of the updated vote.
  • description - Description of the updated vote.
  • maxVotePerUser - Maximum votes allowed per user in the updated vote.
  • winnerCount - Number of winners in the updated vote.
  • deadline - End time of the voting period.
  • startTime - Start time of the voting period.
  • publicVoterInfo - Whether voter information is publicly visible.
  • publicCreate - Whether the public can create options.
  • revote - Whether voters can update their votes.
  • comment - Whether comments are allowed.
  • hideResultBeforeEnd - Whether results are hidden before the poll ends.
  • addBonus - Whether the poll includes a bonus feature.
  • rewardVoters - Whether the bonus is shared with voters.
  • votersBonusPercentage - Percentage of bonus shared with voters.
  • enableOptionLimit - Whether option limit per user is enabled.
  • optionLimit - Maximum options per user if limit is enabled.
  • options - Array of vote options in the poll.

Dependencies

  • An API key credential for authenticating requests to the Vote Kit API

Troubleshooting

  • Ensure the provided Vote ID (pollId) is correct and exists; otherwise, the update will fail.
  • Verify that all required fields are provided and valid, especially when changing critical parameters like maxVotePerUser or winnerCount.
  • Check API authentication credentials if requests fail due to authorization errors.
  • If the update operation fails, review the error message returned by the API for specific issues such as invalid date formats or option list problems.

Discussion