Skip to navigation
HMDb APIReviews

Add Review

View as Markdown

Post your review of a release. One review per user per release. 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.
release_idintegerRequired
The numeric id of the release.
titlestringRequired

Review title (1–200 chars).

bodystringRequired
Review body.
recommendenumRequired
Overall recommendation.
Allowed values:
video_ratingdouble or nullOptional

0.5–5, optional.

audio_ratingdouble or nullOptional

0.5–5, optional.

extras_ratingdouble or nullOptional

0.5–5, optional.

Response

Created — the new review id.

resultobject

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error