Vote on Cover
Up/down-vote a cover image. The highest-scoring cover becomes the release cover. Requires authentication.
Authentication
AuthorizationBearer
A user API key (prefix ak_), created in your HMDb account settings. Send it as Authorization: Bearer ak_…. Required on every request — reads and writes.
Request
This endpoint expects an object.
id
The gallery image id (a Cover item).
release_id
The numeric id of the release.
value
+1 upvote or -1 downvote.
Allowed values:
Response
Vote recorded — new score and your vote.
result
Errors
400
Bad Request Error
401
Unauthorized Error
404
Not Found Error