Sign in
post_votes

Vote on a post

Changed on

Casts a vote on the specified post. Voting again with the same score will remove the vote unless no_unvote is set.

post/posts/{post_id}/votes.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/posts/{post_id}/votes.json
  • Auth: one of:
    • none
    • HTTP basic
    • API key in query parameter login and API key in query parameter api_key

Path parameters

post_idinteger required

The ID of the post to vote on

Request body

score1 | -1 required

The vote score (1 for upvote, -1 for downvote)

no_unvoteboolean

If true, do not remove an existing identical vote

Response

Vote cast successfully

scoreinteger

The new total score of the post

upinteger

The new upvote score of the post

downinteger

The new downvote score of the post

our_scoreinteger

The current user's vote score (0 if unvoted)

Changes