Vote Kit icon

Vote Kit

Consume Vote Kit API

Overview

This node integrates with the Vote Kit API to manage online voting polls and their options. It supports creating, updating, deleting, retrieving, and listing votes (polls) as well as managing individual vote options within those polls.

The "Update Option" operation specifically allows you to update the title of an existing option in a poll. This is useful when you need to correct or change the name of a choice available to voters without altering the entire poll.

Practical examples:

  • Correcting a typo in an option's title after a poll has been published.
  • Renaming an option to better reflect its meaning based on user feedback.
  • Updating options dynamically in response to changing circumstances during a voting period.

Properties

Name Meaning
Title The new title/name for the vote option to be updated.
Vote ID The unique identifier of the poll (vote) that contains the option to update.
Option ID The unique identifier of the specific option within the poll that you want to update.

Output

The node outputs JSON data representing the result of the API call related to the update operation. Typically, this will include details about the updated option such as its ID, updated title, and associated poll ID.

If the operation fails, the output JSON will contain an error message describing the issue.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential to authenticate requests to the Vote Kit API.
  • The node uses HTTP requests to endpoints under /api/poll-options/ and /api/admin/poll/.
  • Proper configuration of the API authentication credential in n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Invalid or missing Vote ID or Option ID parameters will cause the API request to fail.
    • Insufficient permissions or invalid API credentials can lead to authorization errors.
    • Network connectivity problems may prevent communication with the Vote Kit API.
  • Error messages:

    • "error": "Poll not found" — Check that the Vote ID corresponds to an existing poll.
    • "error": "Option not found" — Verify the Option ID is valid within the specified poll.
    • Authentication errors — Ensure the API key credential is correctly set up and has required permissions.

To resolve these errors, verify input parameters, confirm API credentials, and ensure network access to the Vote Kit service.

Links and References

Discussion