downvote

Downvote a Review

This endpoint is used to downvote a specific review.

Request Body

• No request body is required for this endpoint.

Response

The response will be a JSON object with the following schema:

{
  "data": {
    "updatedReview": {
      "_id": "string",
      "book": "string",
      "review": "string",
      "reviewer": "string",
      "rating": 0,
      "upvoters": ["string"],
      "downvoters": ["string"],
      "isRemoved": true,
      "createdAt": "string",
      "updatedAt": "string",
      "__v": 0
    },
    "error": "string"
  }
}

The updatedReview object contains the details of the review after the downvote action, including the review ID, book, review content, reviewer, rating, upvoters, downvoters, removal status, and timestamps. The error field will be null if the request is successful, otherwise, it will contain an error message.

PATCH /reviews/{reviewId}/downvote

downvote

cURL

curl --request PATCH \
  --url http://localhost:8000/v1/reviews/{reviewId}/downvote

200

{
  "data": {
    "updatedReview": {
      "__v": 0,
      "_id": "670c3a4ede2e2e9ee7d34d0f",
      "book": "670bcc0569f877ed50dfacdf",
      "createdAt": "2024-10-13T21:23:26.026Z",
      "downvoters": [
        "670c22148db1109908c9f6b9"
      ],
      "isRemoved": false,
      "rating": 3,
      "review": "A great book, Gilead.",
      "reviewer": "670c22148db1109908c9f6b9",
      "updatedAt": "2024-10-14T12:58:03.864Z",
      "upvoters": []
    }
  },
  "error": null
}

Path Parameters

reviewId · string · required

Example:

"670c3a4ede2e2e9ee7d34d0f"

Response

200 - application/json

downvote - success

data · object

Show child attributes

error · unknown