Community voting on suggestions (Write path). Votes are +1 (upvote), 0 (remove), or -1 (downvote).
Cast or change a vote on a suggestion
Casts a vote on a suggestion. Value 1 is an upvote, -1 is a downvote, and 0 removes a previous vote. Each user can have at most one active vote per suggestion. Returns the updated vote tallies (score, upvotes, downvotes). Requires authentication.
Cast or change a vote on a suggestion › Request Body
suggestionIdID of the suggestion to vote on
valueVote value: 1 (upvote), 0 (remove), -1 (downvote)
Cast or change a vote on a suggestion › Responses
Vote recorded successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Updated vote tallies returned after casting a vote. Reflects the new totals for the target suggestion.
Get the authenticated user's votes
Returns the current user's votes, optionally filtered by a comma-separated list of suggestion IDs. Returns a map of suggestionId to vote value. Requires authentication.
query Parameters
suggestionIdsComma-separated list of suggestion IDs to filter votes for. Omit to return all votes.
Get the authenticated user's votes › Responses
Votes retrieved successfully
statusMachine-readable status code
messageHuman-readable status message
traceIdUnique request trace ID for debugging and log correlation
Map of the authenticated user's votes. Keys are suggestion IDs, values are vote values (1, 0, or -1).