Skip to main content
POST
Record Vote
Record a user’s vote on a specific question. Multiple votes can be submitted for the same question, with each new vote overwriting the previous one. Downvotes can include optional feedback.
Important: Feedback (votes) can only be given for normal answers. Simple interactions and clarifications cannot receive votes. Attempting to vote on these question types will return a 400 error. You can check whether a question can receive feedback by checking the can_receive_feedback field returned by the Ask Question endpoint.

Path Parameters

string
required
The type/slug of the Guru

Headers

string
required
Your API key for authentication. You can obtain your API key from the Gurubase dashboard.

Body Parameters

string
required
The slug identifier of the question to vote on
string
Optional binge session identifier. Can be None
string
required
The type of vote to record. Must be either “upvote” or “downvote”
string
Optional feedback text for downvotes. Maximum 200 characters

Response

string
The recorded vote type (“upvote” or “downvote”)
string
The feedback provided with the vote (if any)
string
Error message or status message

Notes

  • Multiple votes can be submitted for the same question. Each new vote overwrites the previous vote.
  • Feedback (votes) can only be given for normal answers. Simple interactions and clarifications cannot receive votes.
  • Feedback is optional but limited to 200 characters
  • The binge_id parameter can be null, empty string, or “None” and will be treated as null
  • Only “upvote” and “downvote” are valid vote types